378d599125
Multi-agent AI automation system with shared message bus, specialized roles (coder/researcher/reviewer), and deny-by-default security. - Config system with Pydantic validation and YAML loading - Async message bus with inter-agent delegation - LLM providers: Anthropic (Claude) and LiteLLM (DeepSeek/Kimi/MiniMax) - Tool system: registry, builtins (file/bash/web), approval engine, MCP client - Agent engine with tool-calling loop and orchestrator for multi-agent management - CLI channel (REPL) and Discord channel - Docker + Dockge deployment config - Typer CLI: chat, serve, status, agents commands Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# xtrm-agent — Claude Code Instructions
|
|
|
|
## Project
|
|
Multi-agent AI automation system with shared message bus, specialized roles, and deny-by-default security.
|
|
|
|
## Stack
|
|
- Python 3.12+, uv for dependency management
|
|
- Anthropic SDK for Claude, LiteLLM for DeepSeek/Kimi/MiniMax
|
|
- discord.py for Discord, prompt-toolkit + rich for CLI
|
|
- MCP Python SDK for tool server connections
|
|
- Pydantic for config validation, typer for CLI
|
|
|
|
## Structure
|
|
- `xtrm_agent/` — Main package
|
|
- `xtrm_agent/llm/` — LLM providers (Anthropic, LiteLLM)
|
|
- `xtrm_agent/tools/` — Tool registry, builtins, approval, MCP, delegate
|
|
- `xtrm_agent/channels/` — CLI and Discord channels
|
|
- `agents/` — Agent definitions (markdown + YAML frontmatter)
|
|
- `config.yaml` — Main configuration
|
|
|
|
## Commands
|
|
- `uv run xtrm-agent chat` — Interactive REPL
|
|
- `uv run xtrm-agent chat -m "msg"` — Single-shot
|
|
- `uv run xtrm-agent serve` — Production (Discord + all agents)
|
|
- `uv run xtrm-agent status` — Show config
|
|
- `uv run xtrm-agent agents` — List agents
|
|
|
|
## Key Patterns
|
|
- Message bus (asyncio queues) decouples channels from agents
|
|
- Router resolves @mentions, channel defaults, delegation targets
|
|
- Per-agent tool filtering via registry.filtered()
|
|
- Deny-by-default approval engine
|
|
- Agent definitions in markdown with YAML frontmatter
|
|
- Inter-agent delegation via DelegateTool + AgentMessage bus
|