# xtrm-agent

Multi-agent AI automation system with shared message bus, specialized roles, and deny-by-default security.

## Architecture

Multiple specialized agents share a message bus and can delegate to each other:

- **Coder Agent** — Claude, file+bash tools, coding-focused
- **Researcher Agent** — DeepSeek/Kimi, web tools, research-focused
- **Reviewer Agent** — Claude, read-only tools, code review

## Quick Start

```bash
# Install
uv sync

# Interactive chat (default: coder agent)
uv run xtrm-agent chat

# Target a specific agent
uv run xtrm-agent chat --agent researcher

# Single-shot message
uv run xtrm-agent chat -m "write a hello world script"

# Run all agents + Discord bot
uv run xtrm-agent serve

# Show status
uv run xtrm-agent status
```

## Configuration

Edit `config.yaml` to configure providers, agents, tools, and channels.
Agent definitions live in `agents/*.md` with YAML frontmatter.

## Deployment

Deploy via Dockge on Unraid using the included `compose.yaml`.