Introduction
AI-powered development assistant for building agents with the Astreus framework. The CLI helps you create, test, and iterate on AI agents directly from your...
AI-powered development assistant for building agents with the Astreus framework. The CLI helps you create, test, and iterate on AI agents directly from your terminal - with full knowledge of the Astreus SDK.
Why Astreus CLI?
The Astreus CLI is designed for developers who know the Astreus framework and want to accelerate their agent development workflow. It provides:
- Astreus SDK Expert - The AI understands the complete Astreus framework: Agent creation, memory, knowledge base, plugins, MCP, sub-agents, graphs, and more
- Project Scaffolding - Generate complete agent projects with proper structure, types, and configurations
- Code Generation - Create agents, plugins, tools, and integrations with production-ready code
- Multi-Provider Testing - Switch between OpenAI, Claude, Gemini, and local models to test your agents
- File Operations - AI can read, write, and edit your project files directly
- Session Persistence - Continue agent development across multiple sessions
Who Is This For?
The CLI is built for developers who:
- Are familiar with the Astreus framework and want to build AI agents
- Want an AI assistant that understands Astreus patterns and best practices
- Need to quickly scaffold agent projects or generate boilerplate code
- Want to iterate on agent configurations and test different approaches
Quick Example
# Install and start
npm install -g @astreus-ai/astreus-cli
export OPENAI_API_KEY=your-api-key
astreusYou: Create a customer support agent with memory and a knowledge base for our FAQ
Astreus: I'll create a customer support agent for you.
[Tool: list_directory] Checking current directory...
[Tool: create_directory] Creating src/...
[Tool: write_file] Creating src/agent.ts...
[Tool: write_file] Creating src/index.ts...
[Tool: write_file] Creating package.json...
[Tool: write_file] Creating .env.example...
Done! I've created a complete customer support agent with:
- Memory enabled for conversation history
- Knowledge base setup for FAQ documents
- Streaming responses configured
- TypeScript with proper types
Run `npm install && npm run dev` to start the agent.What Can You Build?
| Use Case | CLI Helps You With |
|---|---|
| Conversational Agents | Memory configuration, context management, streaming setup |
| RAG Agents | Knowledge base integration, document ingestion, retrieval tuning |
| Tool-Using Agents | Plugin creation, tool definitions, handler implementations |
| Multi-Agent Systems | Sub-agent coordination, graph workflows, task delegation |
| MCP Integrations | Server configuration, tool discovery, capability mapping |
Key Features
| Feature | Description |
|---|---|
| Framework Knowledge | Built-in understanding of Astreus SDK patterns and APIs |
| Code Generation | Create agents, plugins, and complete projects |
| Multi-Provider | Test with OpenAI, Claude, Gemini, or Ollama |
| File Tools | Read, write, edit project files directly |
| Session Memory | Continue development across sessions |
| Project Context | Attach folders to give AI full project awareness |
Next Steps
- Installation - Get started with installation
- Commands - Learn all available commands
- Providers - Configure LLM providers
- Framework Docs - Learn the Astreus framework
Last updated: May 26, 2026