The Autonomous AI Coding Agent Built for Your Terminal
Zero npm runtime bloat. Full-screen interactive TUI. True unattended autonomy with file checkpoints, instant /undo, background shell tasks, and universal OpenAI & Anthropic compatibility.
Experience the Terminal Interface
Interactive, responsive, full-screen TUI with collapsible tool cards and live status.
src/auth.ts lines 15-40 to inspect existing mutex logic.2. Create file checkpoint snapshot #1.
3. Apply atomic semaphore lock on refresh queue.
4. Run test suite to verify regression.
edit_file applied patch to src/auth.ts (checkpoint #1 saved)Everything You Need to Ship Faster
No heavy Python harnesses or fragile electron wrappers. A lightning-fast, resilient CLI tool that lives inside your terminal.
Zero Runtime Dependencies
Engineered purely using modern Node.js standard modules. No bloated node_modules in production, zero supply-chain vulnerabilities, and instant startup in under 1 second.
True Autonomous Auto Mode
When switched to Auto Mode, Kovence executes multi-step plans without badgering you with approval prompts. Protected by strict workspace sandboxing and audit logs.
File Checkpoints & Instant /undo
Every file write, edit, delete, and patch creates an automated checkpoint snapshot. Type /undo at any turn to immediately restore files to their exact prior state.
Full-Screen TUI & Plain REPL
Rich terminal UI with collapsible tool outputs, mouse-click folding, custom themes (Amber, Dark, Light, Terminal), and word navigation. Fallback to --plain for headless pipes.
Universal LLM Compatibility
Plug into OpenAI, Anthropic, Groq, DeepSeek, Ollama, or LiteLLM. Never leak keys: apiKeyEnv pulls credentials directly from your environment at runtime.
Background Tasks & Shell Escape
Run tests, builds, and dev servers asynchronously. Stream task outputs with /tasks log <id> or terminate rogue jobs with /tasks kill. Execute shell commands with !cmd.
Precise File Mentions (@file)
Inject targeted context directly using @filename or line-range targeting like @src/app.ts:L15-45. Keeps context tight and token costs low.
Built-in Environment Doctor
Run 'kovence doctor' anytime to verify Node.js version, test system binaries (git, curl), validate JSON configs, and ping live LLM provider endpoints.
Four Granular Agent Modes
Switch anytime using Shift+Tab or the /mode slash command.
Default Mode
Safe, interactive exploration. Asks for confirmation before modifying workspace files, running shell commands, or initiating network downloads.
Accept Edits
Automates file changes while retaining control of shell execution. Great when you trust the agent's code edits but want to supervise terminal commands.
Plan Mode
Pure research and architecture planning. All mutating tools (write_file, edit_file, delete_file) and executing commands are hard-blocked by the engine.
Auto Mode
Unattended autonomous execution. Never prompts for tool approval. Safety is guaranteed through workspace boundaries, audit logs, checkpoints, and instant /undo.
Commands & CLI Options
Type / in the composer to access auto-complete for all commands.
Switch agent mode (default, accept-edits, plan, auto)
Open interactive settings panel (or press Ctrl+,)
Update a persisted setting directly
Interactive wizard to add, switch, or remove AI providers
Pick or switch active model for current provider
Roll back the last file edit, write, or delete checkpoint
Manage background shell tasks (list, log, kill)
Scan project and generate customized KOVENCE.md instructions
Open session picker to switch, create, or delete sessions (Ctrl+S)
Open a fresh isolated session immediately (Ctrl+N)
Rename the current session
Fork the current session into a new branch with full history
Export session transcript as Markdown or JSON
Pop last turn and restore prompt into composer for editing
Retry the last failed or aborted user turn
Display complete session chat history
Compact long conversation history into session summary
Clear current session history and working memory
Show estimated session token cost in USD
Display full context size, speed, and token statistics
Copy last AI response cleanly to system clipboard (Ctrl+Y)
Toggle native terminal mouse selection mode (F2)
Show all slash commands and keyboard shortcuts
Gracefully exit Kovence CLI
Keyboard-First Architecture
Never reach for your mouse unless you want to. Every action has a dedicated keybinding.
TUI Global Keybindings
Composer & Navigation Keybindings
Get Started in Under 60 Seconds
No complex configuration files or background daemons required.
Install globally via npm
Available on npm registry. Runs on any Node.js environment >= 20.12.
Launch & Add Provider
Launch TUI and run /api add wizard. Point to your API key or environment variable.
Run Health Check
Check environment compatibility, tools, and live API connectivity with doctor.
Need to verify your environment?
The built-in kovence doctor subcommand tests Node.js, git, config integrity, and pings your AI endpoints.