chevron-venus

Chevron Venus — multi-model council CLI for your terminal. Orchestration runs locally; no subscription required.

Install

npm install -g chevron-venus
venus

Supports Windows, macOS (Intel + Apple Silicon), and Linux.

One-time Cursor setup (local CLI)

Venus bundles cursor-agent-api and auto-starts it on 127.0.0.1:8787. You only need to log in once:

agent login
venus

The cursor provider routes to local CLI when the bundled API is up, else Cloud Agents API if you set a key with /auth set cursor <key>.

Test the bundled API manually:

Invoke-RestMethod -Method POST -Uri "http://127.0.0.1:8787/v1/run" `
  -ContentType "application/json" `
  -Body '{"prompt":"Reply with exactly: OK"}'

curl -s -X POST http://127.0.0.1:8787/v1/run \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"Reply with exactly: OK"}'

Disable auto-start: VENUS_CURSOR_LOCAL=0. Override URL: VENUS_CURSOR_LOCAL_API.

Features

• Council mode — route prompts across multiple model providers
• Bundled orchestrator — full council loop runs on your machine
• Cursor local + cloud — auto-starts bundled cursor-agent-api; falls back to Cloud API
• MCP customization — /mcp add, /mcp list, /mcp export
• Parallel subagents — /spawn 6 <prompt> (max 6 local workers)
• Bundled venus-mcp — GitHub code/repo search and web fetch

Build from source

cd packages/venus-cli
npm run build

Publishes platform binaries + venus-mcp + cursor-agent-api into vendor/.

License

MIT