Zgent
Project

Vision

Why Zgent exists and where it's headed.

The thesis

Claude Code and Codex will transition from end-user applications to programmable execution engines — the same way Docker became container infrastructure. Zgent is the orchestration layer that coordinates when, how, and where these engines operate.

The shift happening now

2023-2024: AI agents as applications
  └── Users interact directly with Claude Code, Copilot, etc.

2025+: AI agents as infrastructure
  └── Applications call AI agent engines to perform tasks
  └── Similar to: apps don't use browsers directly, they use Playwright

Technology consistently follows this pattern of descending from applications to infrastructure:

DomainApplicationInfrastructure
BrowsersWeb browserHeadless Chrome / Playwright
DatabasesMySQLDBaaS / Embedded SQLite
LLMsChatGPTGPT API / Claude API
AI codingClaude Code CLIClaude Agent SDK / Embedded engine

The proactive agent paradigm

Traditional agent frameworks are reactive — they wait for user input. Zgent introduces proactive capabilities where agents act on schedules, events, and triggers without being asked.

The value isn't in when the agent triggers. It's in what it does after:

# Traditional cron job
def daily_check():
    if cpu > 80:
        send_alert("High CPU")  # Human must investigate

# Proactive agent
async def daily_check():
    if cpu > 80:
        logs = await analyze_recent_logs()
        deploys = await check_recent_deployments()
        history = await search_similar_incidents()

        await notify("""
        CPU anomaly detected. Analysis:
        1. Service X deployed yesterday (70% probability)
        2. Historical pattern suggests memory leak (20%)

        Recommended action: Rollback Service X
        """)

Where Zgent fits in the stack

┌─────────────────────────────────────────────────────────┐
│                    Application layer                     │
│         (SaaS products, internal tools, etc.)           │
└────────────────────────┬────────────────────────────────┘

┌────────────────────────▼────────────────────────────────┐
│                    Zgent layer                           │
│  ┌─────────────┐  ┌──────────────┐  ┌────────────────┐  │
│  │  Scheduling │  │    State     │  │ Communication  │  │
│  │  (Channels) │  │  management  │  │    (Hooks)     │  │
│  └─────────────┘  └──────────────┘  └────────────────┘  │
└────────────────────────┬────────────────────────────────┘

┌────────────────────────▼────────────────────────────────┐
│              Agent execution engines                     │
│     Claude Code SDK  │  Codex  │  Future providers      │
└─────────────────────────────────────────────────────────┘
CapabilityZgent componentValue
When to trigger agentsChannelsProactive automation
How to coordinate agentsContext + DispatcherMulti-agent orchestration
What state to maintainAgentContext + SnapshotSession recovery, audit trails
Where to route resultsSenders + FiltersIntegration with existing systems
Why decisions were madeHooks + LoggingObservability and compliance

Differentiation

DimensionTraditional frameworksZgent
Core focus"Better LLM calls""Better agent orchestration"
ExecutionRe-implement agent logicLeverage existing engines
TriggersReactive (user-initiated)Proactive (scheduled, event-driven)
StateStateless or basicFirst-class state management
Multi-providerTight couplingProtocol-based abstraction

On this page