ratchet

Interactive AI agent CLI with multi-provider support, multi-agent orchestration, and a rich terminal UI.

Install

go install github.com/GoCodeAlone/ratchet-cli/cmd/ratchet@latest

Or download a binary from Releases.

Features

• Auto-daemon pattern: Single daemon process serves multiple terminal TUI clients via gRPC over Unix socket
• Multi-provider: Anthropic, OpenAI, Google Gemini, Ollama support
• Multi-agent: Orchestrate teams of agents with role definitions
• Workflow engine: Built on the GoCodeAlone/workflow engine
• Universal instruction files: Loads CLAUDE.md, AGENTS.md, .cursorrules, .windsurfrules, RATCHET.md
• Rich TUI: Bubbletea v2 with streaming tokens, tool call display, permission prompts

Usage

ratchet                     # Launch interactive TUI
ratchet "fix the bug"       # Implicit chat mode
ratchet chat "prompt"       # Explicit chat mode
ratchet sessions            # Manage sessions
ratchet daemon status       # Check daemon
ratchet provider list       # List providers
ratchet team start "task"   # Start agent team