agentabi¶

A unified Python interface for driving coding agent CLIs.

agentabi wraps multiple coding agent CLIs — Claude Code, Codex, Gemini CLI, and OpenCode — behind a single async Python API with streaming support.

Why agentabi?¶

Each coding agent CLI has its own invocation method, output format, and event model. agentabi provides:

• Unified API — One Session class to rule them all. Switch agents with a single parameter.
• Intermediate Representation — All agent events are normalized into a common IR event stream, making cross-agent tooling possible.
• Streaming — Real-time event streaming from any supported agent.
• Auto-detection — Automatically discovers which agent CLIs are installed.
• Provider fallback — Native (subprocess) and SDK providers with automatic fallback chains.

Quick Example¶

import asyncio
from agentabi import Session, detect_agents

async def main():
    # Discover available agents
    agents = detect_agents()
    print(f"Available: {agents}")

    # Run a task
    session = Session(agent="claude_code")
    result = await session.run(prompt="What is 2+2?", max_turns=2)
    print(result["result_text"])

    # Stream events
    async for event in session.stream(prompt="Explain asyncio"):
        if event["type"] == "message_delta":
            print(event["text"], end="", flush=True)

asyncio.run(main())

Supported Agents¶

Getting Started¶

• Installation — Install agentabi and optional dependencies
• Quick Start — Run your first task in 5 minutes
• Streaming — Handle real-time event streams
• Architecture — Understand the provider model and IR design