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 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#

bash

# Install and start
npm install -g @astreus-ai/astreus-cli
export OPENAI_API_KEY=your-api-key
astreus

text

You: 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