Interactive terminal interface for Astreus AI agents - a powerful CLI tool for building and interacting with AI agents.

Installation

npm install -g @astreus-ai/astreus-cli

Usage

# Start the interactive CLI
astreus

# Start with a specific model
astreus --model gpt-4o

# Start with a specific provider
astreus --provider claude

Features

• Interactive Chat: Real-time conversation with AI agents in your terminal
• Multi-Provider Support: Switch between OpenAI, Claude, Gemini, and Ollama
• File System Tools: Built-in tools for file operations (read, write, edit, search)
• Streaming Responses: Real-time streaming of AI responses
• Tool Execution: Visual feedback for tool calls and their results
• Context Management: Automatic context handling for long conversations

Commands

| Command | Description | |---------|-------------| | /model <name> | Switch to a different model | | /provider <name> | Switch to a different provider | | /clear | Clear conversation history | | /help | Show available commands | | /exit | Exit the CLI |

Requirements

• Node.js >= 22.0.0
• One of the supported LLM provider API keys

Related Packages

• @astreus-ai/astreus - Core AI agent framework
• create-astreus-agent - Project scaffolding tool

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

Astreus Team - https://astreus.org

Project Link: https://github.com/astreus-ai/astreus-cli