Proactive Agents with Built-in AI Coding.

The scheduling, state management, and coordination layer for AI agent engines like Claude Code and Codex.

pip install zgent
architecture
Your Application
↓
Zgent
MessagingContext (State)Hooks (Control)
↓
Claude CodeCodexFuture...

The race to the bottom.

Most frameworks compete on who can call LLMs better. Zgent takes a different approach.

Traditional

Re-implement agents
Reactive
Stateless
"Better LLM calls"

Zgent

Leverage existing engines
Proactive
State management
"Better orchestration"

Agents are the new containers.

Container World

Docker=Container Runtime
Kubernetes=Container Orchestrator

Agent World

Claude Code / Codex=Agent Runtime
Zgent=Agent Orchestrator

Built for orchestration.

Channel

When & how agents are triggered

CronChannelHttpChannelWebSocketChannel

Context

State management & conversation history

Session snapshotsToken trackingMessage history

Agent

Define agent behavior

System promptsTools, hooksModel selection

Dispatcher

Route messages to the right agent

Per-sessionShared routingCustom logic

Hook

Intercept & modify agent behavior

Pre/post tool useMessage filteringAudit logging

Tool

Extend agent capabilities

API callsDB queriesFile operations

See it in action.

hello-world.py
import asyncio
from zgent import (
    AgentDefinition, AgentEngine, Context,
    Dispatcher, DispatchResult, DispatchAction,
)
from zgent.channel.memory import MemoryChannel

async def main():
    input_ch = MemoryChannel(name="input")
    output_ch = MemoryChannel(name="output")

    definition = AgentDefinition(
        system_prompt="You are helpful.",
        engine_type=AgentEngine.CLAUDE,
    )

    ctx = Context(
        id="demo",
        receivers=[input_ch],
        senders=[output_ch],
        definitions=[definition],
    )
    await ctx.serve()

asyncio.run(main())

Where we're headed.

Phase 1: Foundation

Current
Python SDK + Claude integration
Channel abstractions (Cron, HTTP, WS)
State management & Hooks
Docs & examples

Phase 2: Multi-Engine

Next
Codex provider
TypeScript SDK
Plugin system

Phase 3: Production

Future
Distributed scheduling
Multi-agent coordination
Observability & tracing

Open source. See licensing.

Built for developers who need real infrastructure, not another wrapper.

pip install zgent