cagent

Build, run, and share powerful AI agents with a declarative YAML config, rich tool ecosystem, and multi-agent orchestration — by Docker.

Get Started GitHub →
🤖

Declarative Agents

Define agents in simple YAML — their model, tools, behavior, and relationships. No framework code required.

🔧

Rich Tool Ecosystem

Built-in tools for filesystem, shell, memory, and more. Extend with any MCP server — local, remote, or Docker-based.

👥

Multi-Agent Orchestration

Create teams of specialized agents that delegate tasks to each other automatically via a coordinator.

🧠

Multi-Model Support

Use OpenAI, Anthropic, Google Gemini, AWS Bedrock, Docker Model Runner, or bring your own provider.

📦

Package & Share

Push agents to any OCI-compatible registry. Pull and run them anywhere — just like container images.

🖥️

Multiple Interfaces

Beautiful TUI for interactive sessions, CLI for scripting, HTTP API for integrations, and MCP mode for interop.

See It in Action

cagent TUI demo showing an interactive agent session

Quick Example

Create a file called agent.yaml:

agents:
  root:
    model: anthropic/claude-sonnet-4-0
    description: A helpful coding assistant
    instruction: |
      You are an expert developer. Help users write clean,
      efficient code and follow best practices.
    toolsets:
      - type: filesystem
      - type: shell
      - type: think

Then run it:

# Launch the interactive TUI
cagent run agent.yaml

# Or run a one-shot command
cagent run --exec agent.yaml "Explain the code in main.go"

Explore the Docs

🚀

Getting Started

Learn what cagent is and get your first agent running in minutes.
💡

Core Concepts

Understand agents, models, tools, and multi-agent orchestration.
⚙️

Configuration

Complete reference for agent, model, and tool configuration.
✨

Features

TUI, CLI, MCP mode, RAG, Skills, and distribution.
🧠

Model Providers

OpenAI, Anthropic, Gemini, AWS Bedrock, Docker Model Runner, and custom providers.
🤝

Community

Contributing guidelines, troubleshooting, and more.