Autonomous AI Agent
0 Runtime Dependencies
Node ≥ 20.12

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.

$npm install -g kovence-cli
MIT License & Safe Sandboxing
0
Runtime Dependencies
< 1s
Cold Boot Time
4 Modes
Plan / Edit / Auto / Def
53/53
Passed Test Suite

Experience the Terminal Interface

Interactive, responsive, full-screen TUI with collapsible tool cards and live status.

KOVENEC.CLI
API: openai-prod · Model: gpt-4o / claude-3-7-sonnet · Mode: accept-edits
YOU > Inspect @src/auth.ts:L15-40 and patch the token refresh race condition.
KOVENCE CLI · Multi-turn execution
1. Read 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.
✓ Tool edit_file applied patch to src/auth.ts (checkpoint #1 saved)
>Type message · Shift+Enter newline · / commands · @ file
Built for Engineers

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.

Pure Node.js

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.

Unattended Autonomy

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.

Safe Iteration

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.

Dual Interface

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.

OpenAI & Anthropic

Universal LLM Compatibility

Plug into OpenAI, Anthropic, Groq, DeepSeek, Ollama, or LiteLLM. Never leak keys: apiKeyEnv pulls credentials directly from your environment at runtime.

Process Management

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.

Smart Context

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.

Diagnostics

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.

Security & Autonomy Matrix

Four Granular Agent Modes

Switch anytime using Shift+Tab or the /mode slash command.

Careful

Default Mode

Safe, interactive exploration. Asks for confirmation before modifying workspace files, running shell commands, or initiating network downloads.

File edits:Confirms each edit
Shell commands:Confirms each command
Downloads:Confirms URL & size
Best for: First-time users & critical production repos
Balanced

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.

File edits:Auto-approved in workspace
Shell commands:Confirms each command
Downloads:Confirms URL & size
Best for: Day-to-day feature development & refactoring
Read-Only

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.

File edits:Blocked (Read-only)
Shell commands:Blocked (Read-only)
Downloads:Blocked
Best for: Auditing unfamiliar codebases & designing plans
Autonomous

Auto Mode

Unattended autonomous execution. Never prompts for tool approval. Safety is guaranteed through workspace boundaries, audit logs, checkpoints, and instant /undo.

File edits:Auto-approved
Shell commands:Auto-approved (sandboxed)
Downloads:Auto-approved
Best for: Autonomous overnight tasks & trusted CI pipelines
Interactive Reference

Commands & CLI Options

Type / in the composer to access auto-complete for all commands.

Category:
/mode/mode auto

Switch agent mode (default, accept-edits, plan, auto)

/settings

Open interactive settings panel (or press Ctrl+,)

/set/set colorScheme dark

Update a persisted setting directly

/api/api add

Interactive wizard to add, switch, or remove AI providers

/model/model claude-3-7-sonnet

Pick or switch active model for current provider

/undo

Roll back the last file edit, write, or delete checkpoint

/tasks/tasks log 101

Manage background shell tasks (list, log, kill)

/init

Scan project and generate customized KOVENCE.md instructions

/sessions

Open session picker to switch, create, or delete sessions (Ctrl+S)

/new

Open a fresh isolated session immediately (Ctrl+N)

/rename/rename auth-refactor

Rename the current session

/fork/fork experiment-1

Fork the current session into a new branch with full history

/export/export md notes.md

Export session transcript as Markdown or JSON

/edit-last

Pop last turn and restore prompt into composer for editing

/retry

Retry the last failed or aborted user turn

/history

Display complete session chat history

/compact

Compact long conversation history into session summary

/clear

Clear current session history and working memory

/cost

Show estimated session token cost in USD

/stats

Display full context size, speed, and token statistics

/copy

Copy last AI response cleanly to system clipboard (Ctrl+Y)

/select

Toggle native terminal mouse selection mode (F2)

/help

Show all slash commands and keyboard shortcuts

/exit

Gracefully exit Kovence CLI

Productivity & Ergonomics

Keyboard-First Architecture

Never reach for your mouse unless you want to. Every action has a dedicated keybinding.

TUI Global Keybindings

Open Settings panel modal
Ctrl,
Open interactive Session picker
CtrlS
Start a fresh isolated session
CtrlN
Copy last AI response to clipboard
CtrlY
Clear screen and redraw full TUI
CtrlL
Toggle last collapsible tool block
CtrlO
Cycle agent mode (default → accept-edits → plan → auto)
ShiftTab
Toggle terminal native mouse select mode
F2

Composer & Navigation Keybindings

Send message / execute command
Enter
Insert newline without sending
ShiftEnter
Accept slash command or @file auto-complete
Tab
Navigate input history or suggestions
↑↓
Jump word-by-word (also Alt+B / Alt+F)
Ctrl← / →
Delete word backward (also Alt+Backspace)
CtrlW
Cancel turn if busy / Exit if idle
CtrlC
Clear current input / Close open modal
Esc
Zero Setup Friction

Get Started in Under 60 Seconds

No complex configuration files or background daemons required.

1Installation

Install globally via npm

Available on npm registry. Runs on any Node.js environment >= 20.12.

npm i -g kovence-cli
2Configuration

Launch & Add Provider

Launch TUI and run /api add wizard. Point to your API key or environment variable.

kovence → /api add
3Diagnostics

Run Health Check

Check environment compatibility, tools, and live API connectivity with doctor.

kovence doctor

Need to verify your environment?

The built-in kovence doctor subcommand tests Node.js, git, config integrity, and pings your AI endpoints.