ag-client

Official Python client for Aegis — orchestration middleware for Claude Code.

Install

pip install ag-client

Quick Start

from aegis_python_client import AegisClient

client = AegisClient(
    base_url="http://localhost:9100",
    auth_token="your-token",
)

# List all sessions
sessions = client.list_sessions()
for s in sessions.get("sessions", []):
    print(s["id"], s.get("name", ""))

# Create a new session
result = client.create_session(
    work_dir="/path/to/project",
    name="my-session",
)
session_id = result["id"]

# Send a message
client.send_message(session_id, "Implement feature X")

# Get session metrics
metrics = client.get_session_metrics(session_id)
print(metrics)

Features

• Zero external HTTP dependencies — uses only urllib from stdlib
• Pydantic v2 models — all request/response types generated from OpenAPI spec
• Full API coverage — 53 endpoints: sessions, pipelines, templates, memory, auth, monitoring
• Type-safe — full type annotations throughout

Regenerating Models

When openapi.yaml changes at the repo root:

python -m pip install -e "packages/python-client[dev]"
npm run sdk:py:generate
npm run sdk:py:check

npm run sdk:py:check regenerates the Pydantic models from the root OpenAPI contract and fails if src/aegis_python_client/models.py has drifted.

License

MIT