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>
1.3 KiB
1.3 KiB
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 packagextrm_agent/llm/— LLM providers (Anthropic, LiteLLM)xtrm_agent/tools/— Tool registry, builtins, approval, MCP, delegatextrm_agent/channels/— CLI and Discord channelsagents/— Agent definitions (markdown + YAML frontmatter)config.yaml— Main configuration
Commands
uv run xtrm-agent chat— Interactive REPLuv run xtrm-agent chat -m "msg"— Single-shotuv run xtrm-agent serve— Production (Discord + all agents)uv run xtrm-agent status— Show configuv 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