OrcheGuide

AI Coding Agent Orchestrator – runs locally, connects Slack to AI coding agents (Cursor CLI, OpenClaw), with session management and audit trails.

Features

• Slack integration – Socket Mode for DMs and channels
• Agent orchestration – Cursor CLI, OpenClaw (configurable per project)
• Session management – Full transcript storage, continuation via threads
• Hooks – beforeSessionStarted, beforeAgentRun, afterAgentRun, afterSessionEnded
• Health check – orcheguide doctor

Quick Start

pnpm install
pnpm build

# First-time setup
pnpm dev onboard

# Start gateway (after onboarding)
pnpm dev gateway start

Commands

| Command | Description | |---------|-------------| | orcheguide onboard | Interactive first-time setup | | orcheguide gateway start | Start the gateway daemon | | orcheguide gateway stop | Stop the gateway | | orcheguide gateway status | Check gateway status | | orcheguide doctor | Health check | | orcheguide session list | List sessions | | orcheguide session show <id> | Show session details |

Configuration

Config: ~/.orcheguide/orcheguide.json
Database: ~/.orcheguide/orcheguide.db

Override with ORCHEGUIDE_HOME env var.

Development

pnpm dev              # Run CLI (tsx)
pnpm test             # Unit tests
pnpm test:integration # Integration tests

Note: Requires Node.js >= 22.12.0 (uses built-in node:sqlite). DB unit tests are excluded from Vitest due to node:sqlite resolution; integration tests cover DB via CLI.

Architecture

See docs/architecture.md, docs/product_spec.md, docs/usecases.md.