English · 简体中文
A coding agent that searches, remembers, executes, and verifies across terminal and desktop.
Quick start · Benchmark & Comparison · Key features · Documentation
Standalone application with built-in Metis CLI and Server runtime (no Node.js required):
macOS (Apple Silicon): DownloadMetis-*-macos-arm64.dmg
from thelatest GitHub Releaseand drag toApplications.** Windows (x64)**: DownloadMetis-*-win-x64-setup.exe
or.zip
from thelatest GitHub Release.
CLI installation
Requires Node.js >=22.19.0
.
npm install -g @wholiver_hu/metis
metis
Run in any repository or directory:
metis "Explain this repository"
metis @src/main.ts "Review this file"
git diff | metis -p "Review this diff"
Use /login
for subscription providers or configure an API key. See Quickstart for the complete guide.
In a controlled benchmark run using the same model (DeepSeek V4 Flash), same 89 real-world tasks, identical budget, and environment:
| Agent Framework | Model | Benchmark | Solved (Accuracy) | Architecture & Harness Advantage |
|---|---|---|---|---|
| 🏆 Metis | ||||
| DeepSeek V4 Flash | Terminal-Bench 2.1 (89 tasks) | 73 / 89 (82.02%) | ||
| ✅ Recursive 5-role agents + SQLite memory + Plan/Build | ||||
| OpenCode | ||||
| DeepSeek V4 Flash | Terminal-Bench 2.1 (89 tasks) | 60 / 89 (67.42%) | ||
| 📈 Improvement | ||||
| Same Model & Budget | ||||
| Same Environment | ||||
| +14.6% (+13 tasks) | ||||
| 🚀 Harness, memory, and verification gates alone |
| Capability | Metis | Claude Code | OpenCode | Cursor / Cline |
|---|---|---|---|---|
| License & Pricing | ||||
| ✅ MIT ($0 Free) | ||||
| ❌ Proprietary | ✅ MIT ($0 Free) | |||
| Model Freedom | ||||
| ✅ Any Model / OrcaRouter | ||||
| ❌ Anthropic Only | ✅ Multi-Provider | |||
| User Interfaces | ||||
| ✅ TUI + React Desktop | ||||
| Workflow Mode | ||||
| ✅ Plan ↔ Build Dual-Mode | ||||
| Multi-Agent System | ||||
| ✅ Recursive L0→L4 (5 Roles) | ||||
| ❌ None | ||||
| Durable Memory | ||||
| ✅ SQLite + Vector Search | ||||
| ❌ Ephemeral | ❌ Ephemeral | |||
| Verification Gates | ||||
| ✅ Test Gates + Video Evidence | ||||
| Headless Benchmark | ||||
| ✅ Python Adapter + Trace | ||||
| ❌ None | ❌ None |
Plan & Build Dual Workflows— Safely investigate in read-only Plan mode, then execute approved plans with a live-updating checklist in Build mode.** Dual Interface for Terminal & Desktop**— Work directly in your terminal via the rich interactive TUI, or use the dedicated React/Vite Desktop workspace on macOS and Windows.Recursive Multi-Agent System— Native named agents (coordinator
,planner
,implementer
,reviewer
,verifier
) with L0→L4 recursive delegation and Git Worktree isolation.Durable Memory & Resumable Sessions— Project knowledge and decisions persist in SQLite across restarts, context compactions, and session forks.** Extensible & Model-Agnostic**— Use any LLM provider (OpenAI, Anthropic, DeepSeek, OrcaRouter, Gemini, Groq, Ollama, vLLM) and extend with TypeScript plugins, Agent Skills, and MCP.Benchmark-Grade Reliability— Automated verification gates, video evidence inspection, and full Terminal-Bench & Harbor evaluation readiness.
| Topic | Guide |
|---|---|
| Install, authenticate, and start | |
Using Metis·TUIProviders·Custom models·Custom providersNamed Agents & DelegationTerminalBench & HarborSessions·CompactionExtensions·Skills·PackagesPrompt templates·Themes·KeybindingsSDK·RPC·JSONVideo toolSecurity·SettingsWindows·Termux·tmux·ContainersSee the documentation index for every guide.
Developer information
npm run build # Compile TypeScript and copy runtime assets
npm test # Run the Vitest suite
npm run clean # Remove compiled output
npm run build:binary # Build the standalone binary
npm --prefix desktop run dev # Start the React/Vite Desktop app in development
npm --prefix desktop run build # Build the renderer and Electron artifact
The package exports the Node.js SDK from @wholiver_hu/metis
and the RPC entry point from @wholiver_hu/metis/rpc-entry
.
Contributions are welcome. See CONTRIBUTING.md for development, Extension and Package integration, testing, and AI-assisted contribution guidance.
Distributed under the MIT License.