This project provides a programmable bridge that transforms coding CLIs (Claude Code, Codex, Gemini, Cursor) into headless, agentic engines. It enables programmatic control over coding sessions, offering persistent sessions, multi-engine orchestration, multi-agent collaboration, and a tool-based API, abstracting CLI complexities for AI agents.

How It Works

The core approach wraps coding CLIs, exposing their capabilities via a unified ISession interface for programmatic session management. This allows agents to start sessions, send tasks, manage context, and coordinate teams across different AI models and engines. It offers a managed coding agent experience with built-in orchestration for file editing, tool use, and multi-turn conversations, distinct from direct API completion calls.

Quick Start & Requirements

• Install: One-line bash script (curl -fsSL https://raw.githubusercontent.com/Enderfga/openclaw-claude-code/main/install.sh | bash) for npm/OpenClaw plugin, or npm install -g @enderfga/openclaw-claude-code for standalone.
• Prerequisites: Node.js >= 22, Claude Code CLI >= 2.1 (npm install -g @anthropic-ai/claude-code), OpenClaw >= 2026.3.0 (optional), Codex CLI >= 0.112 (optional) (npm install -g @openai/codex), Gemini CLI >= 0.35 (optional) (npm install -g @google/gemini-cli), Cursor Agent CLI (optional).
• Docs: See skills/references/getting-started.md within the repository.

Highlighted Details

• Multi-Engine Sessions: Unified ISession interface for Claude Code, Codex, Gemini, and Cursor, managing subprocesses, events, and costs per engine.
• Multi-Agent Council: Parallel agent collaboration with git worktree isolation, consensus voting, and a plan-then-execute protocol.
• 27 Tools: Comprehensive API for session management, operations, agent teams, council orchestration, Ultraplan, and Ultrareview.
• OpenAI-Compatible API: Drop-in backend for webchat frontends, supporting stateful sessions and prompt caching.
• Specialized Features: Ultraplan for detailed project plans, Ultrareview for parallel codebase analysis.

Maintenance & Community

The README does not detail specific contributors, sponsorships, or community channels (e.g., Discord/Slack). Contribution guidelines are available via CONTRIBUTING.md.

Licensing & Compatibility

• License: MIT.
• Compatibility: Permissive MIT license supports commercial use and integration with closed-source projects.

Limitations & Caveats

Team tools use virtual layers for non-Claude engines. Codex/Gemini/Cursor sessions are one-shot, carrying context via working directory, not conversation history. Council consensus requires explicit [CONSENSUS: YES/NO] tags. Inbox messages are queued but not retained in history. Plugin compatibility may require updates if underlying CLI versions change flags or output formats.