agentabi

Unified interface layer for agentic coding CLIs.

One interface. Any coding agent.

What is agentabi?

agentabi provides a stable, unified interface (an "ABI") for interacting with different agentic coding CLIs. Write your integration once, swap agents with a config change.

Supported Agents

Installation

pip install agentabi

Note: You also need at least one agent CLI installed: claude, codex, agy, opencode, or pi.

Optional SDK dependencies

pip install agentabi[claude]    # Claude Agent SDK
pip install agentabi[codex]     # Codex SDK

Quick Start

import asyncio
from agentabi import Session

async def main():
    session = Session(agent="claude_code")
    result = await session.run(prompt="What is 2+2?")
    print(result["result_text"])

asyncio.run(main())

Key Features

Unified TaskConfig

All agents accept the same TaskConfig with fields for:

• Agent selection: agent, model
• Reasoning control: thinking_level ("off", "low", "medium", "high", "max")
• Structured output: output_schema (JSON Schema)
• Session management: session_id, resume, ephemeral
• Workspace: working_dir, additional_dirs, files
• Permissions: permissions, allowed_tools, disallowed_tools
• System prompts: system_prompt, append_system_prompt

Unified IR Events

All agents emit the same streaming events:

• session_start / session_end — session lifecycle
• message_start / message_delta / message_end — text streaming
• content_block_start / content_block_end — content block boundaries
• reasoning_delta — thinking/reasoning text (Claude, Pi)
• tool_use / tool_result — tool calls
• usage — token counts (including reasoning_tokens)
• error — error reporting

Documentation

• English docs
• 中文文档

License

MIT