DOCUMENTATION
Relentless coding agent — acts immediately, orchestrates complex tasks.
An AI coding orchestrator that scales thinking to task complexity. Handles simple requests instantly and orchestrates multi-step workflows with parallel subagents, surgical edits, and BM25 code search — built on Rust for zero-drop reliability.
01 · QUICKSTART
Install via Homebrew, cargo-binstall, or download the binary directly.
# Homebrew (macOS) brew install epicsagas/tap/collet # Pre-built binary cargo binstall collet # Download from Releases curl -sL https://github.com/epicsagas/collet/releases/latest/download/collet-$(uname -m)-$(uname -s) -o collet
Run setup to configure your LLM provider, then launch the TUI or run headless.
collet setup # Interactive setup collet # Launch TUI collet "hello collet!" # Headless mode
02 · CORE CONCEPTS
Connects to any LLM provider with SSE streaming. Switch providers mid-session. Supports OpenAI, Anthropic, Google, local models via Ollama, and more.
AST symbol extraction for Rust, Python, TypeScript, and Go with PageRank ranking. BLAKE3 incremental hashing with mtime pre-check re-parses only changed files.
Precise string replacement without full file rewrites. Edit exactly what needs changing, nothing more.
Split tasks for parallel execution, then merge results. Team mode adds real-time inter-agent communication and consensus voting.
3-tier progressive skill system based on YAML frontmatter. Soul.md adds persistent agent personality — the agent self-records identity, voice, inner world, and growth sections.
03 · REFERENCE
Core capabilities available in every session.
# Code Search (BM25) Auto-indexed, code-aware tokenizer # LSP/MCP Integration 35+ languages, 48+ servers, automatic fallback # Session Persistence --continue / --resume with auto-save # Auto Compaction SimHash dedup + scored verbatim + structured summary # Stuck Prevention Iteration limits, circuit breakers, Tokio timeouts # Tool Approval Gate 3-tier: Yolo / Auto / Manual (Shift+Tab to switch) # Themes 6 color themes: Dracula, Catppuccin, and more # RAG Document Search Alcove local docs + HTTP Bridge external services
Native JetBrains support and VSCode extension via ACP server.
04 · CONFIGURATION
Full configuration reference for providers, models, agents, and telemetry. Run collet setup for interactive configuration, or use --advanced for detailed settings.
# Run interactive setup collet setup # Advanced mode with more options collet setup --advanced # Config file location # ~/.config/collet/config.toml
05 · EXAMPLES
Run collet without the TUI for scripting and automation.
# Single prompt collet "refactor the auth module to use JWT" # Continue previous session collet --continue # Resume specific session collet --resume
Split complex tasks across parallel subagents, then merge results.
# In TUI: use parallel mode # Tasks are split → executed in parallel → merged # Team mode: real-time agent communication # Agents share context and vote on consensus