Agenticore Documentation

Agenticore is a Claude Code runner and orchestrator that manages job lifecycle, repo cloning, profile-based execution, auto-PR creation, and OTEL observability.

Request (MCP / REST / CLI)
    |
    v
+---+---+     +--------+     +----------+     +--------+     +--------+
| Router +---->| Clone  +---->| Claude   +---->| Auto-PR+---->| Job    |
|        |     | repo   |     | --worktree|    | gh pr  |     | result |
+--------+     +--------+     | -p "task"|     | create |     | Redis  |
                              +----+-----+     +--------+     | + file |
                                   |                          +--------+
                                   v
                              +----+-----+
                              | OTEL     |
                              | Collector|
                              | -> PG    |
                              +----------+

Getting Started

• Quickstart — Install, start the server, submit your first job
• Connecting Clients — MCP, REST, and CLI client setup

Architecture

• Architecture Internals — Modules, data flow, Redis+file fallback, repo caching
• Dual Interface — MCP + REST ASGI routing and auth middleware
• Profile System — Profile YAML to CLI flags, templates, routing
• Job Execution — Runner pipeline, lifecycle state machine, auto-PR, OTEL

Deployment

• Docker Compose — 4-service stack, volumes, networking
• Kubernetes — Helm chart, values, PVCs, secrets
• OTEL Pipeline — Collector config, PostgreSQL sink
• Releases and CI/CD — Versioning, tests, linting, self-update

Reference

• CLI Commands — All 9 CLI subcommands with flags and examples
• Configuration — All env vars, YAML config, file paths
• API Reference — 5 MCP tools + 6 REST endpoints with schemas