Quickstart

Get Agenticore running and submit your first job in under 5 minutes.

Prerequisites

Tool Required Purpose
Python 3.10+ Yes Runtime
Claude CLI Yes Task execution engine
Git Yes Repo cloning
gh CLI For auto-PR GitHub PR creation
Redis Optional Job store (file fallback available)
Docker Optional Full-stack deployment

Install

From source (development) 

git clone https://github.com/The-Cloud-Clock-Work/agenticore.git
cd agenticore
pip install -e .

With Docker 

git clone https://github.com/The-Cloud-Clock-Work/agenticore.git
cd agenticore
touch .env
docker compose up --build -d

Start the Server

SSE transport (HTTP — recommended) 

agenticore run

The server starts at http://127.0.0.1:8200 with MCP, REST, and health endpoints.

Custom host/port 

agenticore run --host 0.0.0.0 --port 9000

stdio transport (for Claude Code CLI integration) 

AGENTICORE_TRANSPORT=stdio python -m agenticore

Docker 

docker compose up -d

Submit Your First Job

Via CLI 

# Fire-and-forget
agenticore submit "add a hello world endpoint" \
  --repo https://github.com/your-org/your-repo

# Wait for result
agenticore submit "fix the typo in README.md" \
  --repo https://github.com/your-org/your-repo \
  --wait

Via REST API 

curl -X POST http://localhost:8200/jobs \
  -H "Content-Type: application/json" \
  -d '{
    "task": "add a hello world endpoint",
    "repo_url": "https://github.com/your-org/your-repo"
  }'

Via MCP (from an AI client)

Configure your MCP client to connect to http://localhost:8200/sse, then use the run_task tool:

{
  "task": "add a hello world endpoint",
  "repo_url": "https://github.com/your-org/your-repo"
}

Check Job Status 

# List all jobs
agenticore jobs

# Get specific job details
agenticore job <job_id>

# Via REST
curl http://localhost:8200/jobs/<job_id>

Next Steps