Deepcode Ai

Terminuz - The Open Source AI Coding Agent

Terminuz is a local, permission-aware, multi-provider coding agent for the terminal. It understands repositories, executes tools, works with multiple LLM providers, and keeps control of filesystem and shell operations with the user.

The project was previously published as DeepCode. Existing .deepcode/ configuration, DEEPCODE_* variables, sessions, and custom agents remain supported during the migration window. The deepcode-ai compatibility package is supported through 2027-01-08.

Features

• Interactive Ink TUI with streaming, approvals, diff previews, themes, and Vim keybindings
• Non-interactive terminuz run mode for scripts and CI
• Anthropic, OpenAI, DeepSeek, Groq, Ollama, OpenRouter, OpenCode, and MCP
• Filesystem, shell, git, ripgrep, test, lint, and LSP tools
• GitHub authentication, issues, pull requests, review, and merge workflows
• Foreground and background subagents
• Context compaction, token budgets, provider failover, and per-mode routing
• Path policies, approval gateway, audit logs, and secret redaction

Installation

Terminuz requires Node.js 22 or newer.

npm install -g terminuz
terminuz --version

Using pnpm:

pnpm add -g terminuz

Stable channel:

npm install -g --tag stable terminuz
pnpm add -g terminuz@stable

Quick Start

terminuz init
terminuz

Inside the TUI:

/setup      configure provider, API key, and model
/provider   choose a provider
/model      choose a model
/doctor     validate the local environment

Scriptable setup:

terminuz config set defaultProvider deepseek
terminuz config set defaultModels.deepseek "deepseek-chat"
terminuz config set providers.deepseek.apiKey "<your-key>"
terminuz doctor

Environment variables:

export TERMINUZ_PROVIDER=anthropic
export TERMINUZ_MODEL=claude-sonnet-4-5
export ANTHROPIC_API_KEY="<your-key>"
terminuz

Commands

terminuz
terminuz chat
terminuz run "fix the failing tests" --yes
terminuz run "refactor the auth module" --mode plan
terminuz review
terminuz doctor
terminuz update
terminuz cache tmp clear

terminuz github login
terminuz github prs
terminuz github review 42

terminuz subagents run \
  --task "audit the auth module" \
  --task "audit the billing module" \
  --concurrency 2 --yes

Configuration

Terminuz writes project configuration and runtime data under .terminuz/.

{
  "defaultProvider": "anthropic",
  "defaultModels": {
    "anthropic": "claude-sonnet-4-5"
  },
  "permissions": {
    "read": "allow",
    "write": "ask",
    "shell": "ask",
    "mcp": "ask"
  },
  "mcpServers": []
}

Resolution order:

1. explicit CLI config path;
2. TERMINUZ_* environment variables;
3. legacy DEEPCODE_* variables;
4. .terminuz/config.json;
5. legacy .deepcode/config.json;
6. defaults.

Terminuz writes new state to .terminuz/ and does not delete .deepcode/. See the configuration reference and rebranding roadmap.

Migrating from DeepCode

npm uninstall -g deepcode-ai
npm install -g terminuz
terminuz

During the transition:

• deepcode-ai remains a compatibility package;
• deepcode and deepcode-ai invoke Terminuz and display a migration notice;
• .deepcode/config.json is used when .terminuz/config.json is absent;
• DEEPCODE_* variables remain lower-priority aliases;
• legacy user and project sessions are read without deleting or moving them.

The deepcode-ai wrapper remains supported through 2027-01-08. Do not delete .deepcode/ until your migrated project and sessions have been verified.

Development

git clone https://github.com/N1ghthill/terminuz.git
cd terminuz
corepack pnpm install
corepack pnpm build
corepack pnpm dev

Validation:

corepack pnpm validate

Repository layout:

• apps/terminuz - publishable Terminuz package and entrypoint
• apps/deepcode-legacy - temporary deepcode-ai compatibility package
• packages/cli - commands and Ink TUI
• packages/core - agent runtime, providers, tools, security, and integrations
• packages/shared - schemas, identity constants, and shared contracts
• docs - product and engineering reference

Documentation

• Documentation index
• Architecture
• Security model
• Tool system
• Configuration
• Terminuz rebranding roadmap
• Production readiness evidence

Acknowledgments

The Ink-based terminal UI is adapted from Qwen Code under Apache 2.0. The agent architecture also draws inspiration from google-gemini/gemini-cli.

Terminuz adds its own multi-provider runtime, permission-aware tool execution, local intent handling, MCP and GitHub integrations, provider orchestration, token budgets, project discovery, and subagent workflows.

License

Terminuz is released under the MIT License. Adapted components remain subject to their respective licenses.