Astra Suite

Open-source tools for the Astra agent ecosystem.

Astra is an AI agent runtime with planning, memory, tool orchestration, and multi-model routing. Astra Suite provides standalone open-source utilities that extend Astra's reach — each tool works independently and integrates with the broader ecosystem.

---

Tools

Astra Gateway

A production-ready chat-platform gateway that bridges messaging apps to AI agent CLIs.

WeChat / WeCom / (Feishu, WhatsApp planned)
        ↕
   Astra Gateway
        ↕
Claude Code · Codex · Astra · Custom CLI

Highlights:

• Zero-config start — SQLite storage, 3 commands to deploy
• Multi-backend — switch between Claude, Codex, Astra at runtime (/cli, /model)
• Autonomous scheduling — cron jobs that invoke the agent ("每晚 10 点检查 PR 列表并总结")
• Durable tasks — long-running jobs with checkpoint/resume, crash recovery
• Full observability — per-request trace, audit chain, durable outbox with retry
• Multi-user — per-user sessions, access control, group chat isolation

Install:

curl -sSL https://raw.githubusercontent.com/matrixorigin/astra-suite/main/scripts/install.sh | sh

Or grab binaries directly from GitHub Releases.

Quick start:

astra-gateway init     # writes ~/.astra-gateway/config.yaml (WeCom + Claude/Bedrock + SQLite)
# edit the 3 FILL-ME fields: AWS_BEARER_TOKEN_BEDROCK, wecom.bot_id, wecom.secret
astra-gateway start    # run as background daemon
astra-gateway status   # check it's up
astra-gateway stop     # graceful shutdown

Upgrade in place with astra-gateway update.

See crates/astra-gateway/README.md for full documentation.

---

Repository Structure

astra-suite/
├── crates/
│   ├── astra-gateway/     # Gateway binary + library
│   ├── astra/             # HTTP+SSE client for Astra server
│   └── astra-task-store/  # Durable task store trait + types
├── ARCHITECTURE.md        # System design + extension points
├── CONTRIBUTING.md        # Developer workflow
├── Makefile               # Build / test / run targets
└── LICENSE                # MIT

Development

make help           # show all targets
make build          # compile workspace (all targets)
make release        # release build (astra-gateway only)
make check          # format + clippy + test (full CI)
make test           # fast offline tests
make test-live      # all tests including live integrations
make format         # auto-format
make lint           # fmt check + clippy (CI gate)

make init           # generate gateway config + release build
make run            # start gateway (auto-inits config if missing)
make stop           # graceful shutdown
make restart        # stop + start
make log            # tail -f gateway log
make login-weixin   # WeChat QR login
make setup          # run gateway setup script
make clean          # remove all build artifacts

Roadmap

• Astra Gateway (WeChat + WeCom)
• Feishu (飞书) platform adapter
• WhatsApp platform adapter
• Copilot CLI backend
• astra-bench — agent evaluation harness
• astra-sync — cross-device session sync

License

MIT