import { SessionManager } from '@enderfga/openclaw-claude-code';

const manager = new SessionManager();
await manager.startSession({ name: 'task', cwd: '/project' });
const result = await manager.sendMessage('task', 'Fix the failing tests');

See Getting Started for full setup guide.

Features

Multi-Engine Sessions

Drive Claude Code, OpenAI Codex, and Google Gemini through a unified ISession interface. Each engine manages its own subprocess, events, and cost tracking.

// Claude Code engine (default)
await manager.startSession({ name: 'claude-task', engine: 'claude', model: 'opus' });

// Codex engine
await manager.startSession({ name: 'codex-task', engine: 'codex', model: 'o4-mini' });

// Gemini engine
await manager.startSession({ name: 'gemini-task', engine: 'gemini', model: 'gemini-pro' });

See Multi-Engine for architecture and adding new engines.

Multi-Agent Council

Multiple agents collaborate in parallel on the same codebase with git worktree isolation, consensus voting, and a two-phase protocol (plan then execute).

const session = manager.councilStart('Build a REST API with auth', {
  agents: [
    { name: 'Architect', emoji: '🏗️', persona: 'System design', engine: 'claude', model: 'opus' },
    { name: 'Engineer', emoji: '⚙️', persona: 'Implementation', engine: 'codex', model: 'o4-mini' },
    { name: 'Reviewer', emoji: '🔍', persona: 'Code review', engine: 'claude', model: 'sonnet' },
  ],
  maxRounds: 10,
  projectDir: '/tmp/api-project',
});

See Council for the full collaboration protocol.

24 Tools

| Category | Tools | |----------|-------| | Session Lifecycle | claude_session_start, send, stop, list, overview | | Session Operations | status, grep, compact, update_tools, switch_model | | Inbox | session_send_to, session_inbox, session_deliver_inbox | | Agent Teams | agents_list, team_list, team_send | | Council | council_start, council_status, council_abort, council_inject | | Ultraplan | ultraplan_start, ultraplan_status | | Ultrareview | ultrareview_start, ultrareview_status |

See Tools Reference for complete API.

Session Inbox

Cross-session messaging: sessions can send messages to each other. Idle sessions receive immediately; busy sessions queue for later delivery.

await manager.sessionSendTo('planner', 'coder', 'The auth module needs rate limiting');
await manager.sessionSendTo('monitor', '*', 'Build failed!');  // broadcast

Ultraplan

Dedicated Opus planning session that explores your project for up to 30 minutes and produces a detailed implementation plan.

const plan = manager.ultraplanStart('Add OAuth2 support with Google and GitHub providers', {
  cwd: '/project',
});
// Poll: manager.ultraplanStatus(plan.id)

Ultrareview

Fleet of 5-20 bug-hunting agents that review your codebase in parallel, each from a different angle (security, performance, logic, types, etc.).

const review = manager.ultrareviewStart('/project', {
  agentCount: 10,
  maxDurationMinutes: 15,
});
// Poll: manager.ultrareviewStatus(review.id)

And More

• Session Persistence — 7-day disk TTL, auto-resume across restarts
• Multi-Model Proxy — Anthropic ↔ OpenAI format translation for Gemini/GPT
• Cost Tracking — per-model pricing with real-time token accounting
• Effort Control — low to max thinking depth per message
• Runtime Model/Tool Switching — hot-swap via --resume

Architecture

graph TD
    A[OpenClaw / Your Code] -->|tool calls| B[Plugin Entry<br/>index.ts]
    B --> C[SessionManager]
    C --> D[Claude Engine<br/>persistent-session.ts]
    C --> E[Codex Engine<br/>persistent-codex-session.ts]
    C --> K[Gemini Engine<br/>persistent-gemini-session.ts]
    C --> F[Council<br/>council.ts]
    C --> G[Inbox / Ultraplan / Ultrareview]
    F -->|git worktree per agent| D
    B --> H[Proxy Handler]
    H -->|Anthropic format| I[Gemini / GPT / Gateway]
    B --> J[Embedded HTTP Server]

src/
├── index.ts                    # Plugin entry — 24 tools + proxy route
├── types.ts                    # Shared types, ISession interface, model pricing
├── persistent-session.ts       # Claude Code engine (ISession)
├── persistent-codex-session.ts  # Codex engine (ISession)
├── persistent-gemini-session.ts # Gemini engine (ISession)
├── session-manager.ts          # Multi-session orchestration + council management
├── council.ts                  # Multi-agent council orchestration
├── consensus.ts                # Consensus vote parsing
├── embedded-server.ts          # HTTP server for standalone mode
├── hooks/
│   └── prompt-bypass.ts
└── proxy/
    ├── handler.ts              # Provider detection + routing
    ├── anthropic-adapter.ts    # Anthropic ↔ OpenAI conversion
    ├── schema-cleaner.ts       # Gemini schema compatibility
    └── thought-cache.ts        # Gemini thought caching

Documentation

| Doc | Description | |-----|-------------| | Getting Started | Installation, configuration, first session | | Sessions | Persistent sessions, resume, model switching, cost tracking | | Session Inbox | Cross-session messaging | | Multi-Engine | Claude + Codex + Gemini engines, ISession interface | | Council | Multi-agent collaboration, worktree isolation, consensus voting | | Ultraplan & Ultrareview | Deep planning and fleet code review | | Tools Reference | Complete tool API (24 tools) | | CLI Reference | Command-line interface | | Contributing | Dev setup, code style, PR guidelines |

Requirements

• Node.js >= 22
• Claude Code CLI — npm install -g @anthropic-ai/claude-code
• OpenClaw >= 2026.3.0 (optional, for plugin mode)
• Codex CLI (optional) — npm install -g @openai/codex
• Gemini CLI (optional) — npm install -g @google/gemini-cli

License

MIT