v1.2.80 · npm latest MIT License

Terminuz

Terminal-first AI coding agent — local, permission-aware, and multi-provider.

Terminuz operates locally with a permission model you control — read, write, shell, and dangerous operations each have configurable approval policies. Works with Anthropic, OpenAI, DeepSeek, Groq, Ollama, OpenRouter, and MCP.

Get Started View on GitHub
npm install -g terminuz
terminuz ~/repo 
$ terminuz run "ship auth" --yes
reading workspace, tests, and git diff
✓ plan created with 4 permission-gated steps
✓ patched 3 files and updated focused tests
approval required: shell:test
✓ npm test -- auth/session.spec.ts

Features

TUI

Interactive TUI

Ink-based terminal UI with real-time streaming, diff previews, approval flows, and Vim keybindings.

RUN

Non-interactive mode

terminuz run for scripting and CI pipelines — fully automated task execution.

LLM

Multi-provider LLM

Anthropic, OpenAI, DeepSeek, Groq, Ollama, OpenRouter, OpenCode — with automatic failover and per-mode routing.

TLS

Tool System

Filesystem read/write, shell, ripgrep search, git, lint, test runners, LSP symbols — all permission-gated.

MCP

MCP Support

Connect any Model Context Protocol server; tools appear automatically in the agent with server__ prefix.

GIT

GitHub Integration

Authenticate, browse issues, manage pull requests, and run AI code review on any PR from your terminal.

CTX

Context Management

Auto-summarizes conversation history when approaching the model's context limit. Configurable token budgets with hard stops.

SEC

Safety Model

Path allowlist/blacklist, per-operation permission levels, approval gateway, audit logging, and secret redaction.

INT

Intent Classification

Answers greetings, trivial questions, and project discovery without calling an LLM — saving tokens and latency.

Supported Providers

Anthropic
anthropic
Claude 3.x / 4.x family
OpenAI
openai
GPT-4o, o3, o4-mini
DeepSeek
deepseek
deepseek-chat, deepseek-reasoner
Groq
groq
Fast inference, Llama / Mixtral
Ollama
ollama
Local models, no API key required
OpenRouter
openrouter
Unified access to 200+ models
OpenCode
opencode
opencode-go/ model prefix

Core Commands

$ terminuz
Launch interactive TUI
$ terminuz chat
Start a chat session
$ terminuz run "fix the failing tests" --yes
Non-interactive task execution
$ terminuz config show --effective
View effective configuration
$ terminuz doctor
Check installation health
$ terminuz update
Check for updates
$ terminuz github login
Authenticate with GitHub
$ terminuz github review 42
AI code review on a PR
$ terminuz subagents run --task "audit auth" --concurrency 2 --yes
Run parallel subagents

Safety Model

Terminuz acts on a real local repository, so safety is a first-class runtime concern.

FS

Path Control

Allowlist and blacklist enforcement for filesystem access.

ACL

Permission Levels

read, write, gitLocal, shell, dangerous — each with configurable approval policy.

OK

Approval Gateway

Sensitive operations require approval with diff previews before execution.

LOG

Audit Logging

All tool calls are logged for review and debugging.

KEY

Secret Redaction

Known secrets are automatically redacted from logs and agent output.

Get Started

1

Install

Requires Node.js 22 or newer.

npm install -g terminuz

or

pnpm add -g terminuz
2

Configure

terminuz init
terminuz config set defaultProvider deepseek
terminuz config set providers.deepseek.apiKey "sk-..."
3

Run

terminuz doctor
terminuz