The AI coding agent that lives in your terminal.

One key. Every model. Your plan.

Plan, write, refactor, debug and ship — without leaving the shell.

npm install -g vinuscli   →   vinus

Why VinusCLI

A hands-on coding agent, not a chatbot. It reads and writes your files, runs commands, previews every change as a diff, and improves itself by writing its own skills — all in a fast, beautiful terminal UI.

One Vinus key unlocks every frontier model through a single hosted endpoint, billed as a flat subscription with fair-use credits — never per token.

| | | |---|---| | 🧠  Any model, one key | GPT, Claude, Gemini, Llama, Mistral… one hosted endpoint, with an automatic fallback chain. | | 🛠️  Real tools | Read/write files, run shell, web_search, github_search, fetch_url. | | 🎚️  Autonomy dial | Plan · Manual · Auto — switch at any time. | | 📚  Smart skills | 21 curated coding packs (debugging, TDD, GitHub, design, RE…), auto-suggested for the task at hand — and the agent writes its own so it never forgets. | | 🔌  Connectors | GitHub, Canva, Notion, Linear, IDA Pro over MCP. | | 🔍  Reverse engineering | First-class IDA Pro / Ghidra workflow. | | 🖍️  Visual diffs | Green/red previews before anything touches disk. | | 🎨  Themes | Vinus (signature) · Aurora · Graphite · Phosphor · Ember. |

Get started

# 1 — install (requires Node.js ≥ 18)
npm install -g vinuscli

# 2 — launch
vinus

# 3 — sign in — opens your browser, creates a key automatically
/login        # → "1) Sign in with browser"

# 4 — just talk to it
Build me a REST API in Express with a health route and tests.

The agent creates files, runs your tests, and iterates — showing a diff before each write.

Plans

| | Free | Pro | Pro+ | Ultra | |---|:---:|:---:|:---:|:---:| | Price | €0 | €20 / mo | €100 / mo | €200 / mo | | Models | Hosted free | + paid (Claude, GPT, Gemini…) | + top-tier | all frontier | | Included usage | 40 msg / mo | Generous | Higher | ~4× Pro+ | | Credit top-ups | — | ✓ | ✓ | ✓ | | Priority support | — | — | ✓ | ✓ |

Manage your plan and keys at vinuscli.dev/dashboard — fair-use credits, never per-token billing.

Operating modes

| Mode | Command | Behaviour | |------|---------|-----------| | ◇  Plan | /plan | Read-only. Investigates and returns a numbered plan — never writes or runs. | | ◈  Manual | /manual | Acts, but asks your approval every time. | | ◆  Auto | /auto | Full autonomy — pauses only when genuinely unsure. |

The current mode is always visible in the prompt.

Skills & connectors

Skills are progressive-disclosure knowledge packs — light in the prompt, deep on demand. Connectors plug external services in over MCP; their tools become the agent's tools.

/skills              # list bundled skills, grouped by category
/skills install all  # pull the official set
/connect github      # OAuth in the browser → repos, PRs, issues
/mcp                 # add any MCP server

Built-in connectors: GitHub · Canva · Notion · Linear · IDA Pro.

Commands

| Command | Description | |---------|-------------| | /mode · /plan · /manual · /auto | Set agent autonomy | | /model · /effort | Choose model / thinking power (1–5) | | /theme | Switch theme | | /skills · /connect · /mcp | Skills, connectors, MCP servers | | /file · /run · /diff · /commit | Load files, run shell, git | | /resume · /save · /sessions | Session management | | /status · /cost · /usage | Health, tokens, account | | /update | Check for a new version on npm | | /help | Everything |

Configuration

Config lives in ~/.vinuscli/config.json. Set values from inside the CLI:

/login
/config agent.mode auto
/effort

Proprietary — © 2026 Yhano. All rights reserved.  ·  The source is closed; the published package is a runnable build only.

Built for the terminal. Powered by Vinus.