⚡ Verus

AI-powered project management for developer teams

Task tracking · Documentation · Kanban Board · Time Tracking · Semantic Search
All in one command — CLI + Web Dashboard included.

📦 Installation

npm install -g verus

That's it. CLI + Web Dashboard + MCP Server — all in one high-performance native Go binary shipped via npm.

Verify

verus version

🚀 Quick Start

# 1. Initialize in your project
cd your-project
verus init

# 2. Create tasks
verus task create "Implement user auth" --priority high --labels "backend,auth"

# 3. Open Web Dashboard
verus browser

✨ Features

| Feature | CLI | Web Dashboard | |---------|-----|---------------| | 🎯 Task Management | verus task create/edit/list | Full CRUD + detail sheets | | 📋 Kanban Board | verus board | Drag-and-drop columns | | 📝 Documentation | verus doc create/view | Markdown editor + Mermaid | | ⏱️ Time Tracking | verus time start/stop | Live timer in header | | 🔍 Search | verus search <query> | ⌘K command palette | | 🤖 MCP Server | verus mcp | — | | 📦 Templates | verus template run | Browse + run | | 🔄 Imports | verus import add | Manage sources | | 🛠️ Skills | verus skill install | — | | 🔐 Offline Search | verus model download | — | | 🔄 Update | verus update | — |

📋 CLI Reference

Project Setup

verus init                       # Interactive project setup
verus init my-project            # Init with name
verus init --no-wizard           # Non-interactive (use defaults)
verus init --force               # Reinitialize existing project
verus update                     # Update skills, rules, .mcp.json (keeps tasks/docs)
verus update --no-skills         # Skip skill update
verus update --no-rules          # Skip agent guideline update
verus update --no-mcp            # Skip .mcp.json update
verus update --no-config         # Skip config/flow update
verus validate                   # Validate project integrity

Tasks

verus task list                              # List all tasks
verus task list --status in-progress         # Filter by status
verus task list --priority high              # Filter by priority
verus task list --assignee "@me"             # Filter by assignee
verus task create "Fix login bug" -p high    # Create with priority
verus task create "Auth" --labels "be,auth"  # Create with labels
verus task view abc123                       # View task detail
verus task edit abc123 --status done         # Update status
verus task edit abc123 --priority high       # Update priority
verus task edit abc123 --ac "Tests pass"     # Add acceptance criteria
verus task delete abc123                     # Delete task

Documentation

verus doc list                               # List all docs
verus doc create "API Design"                # Create doc
verus doc create "Auth Spec" --folder specs  # Create in folder
verus doc view specs/auth-spec               # View doc content

Time Tracking

verus time start abc123          # Start timer for task
verus time stop abc123           # Stop timer & record
verus time status                # Show active timers
verus time add abc123 2h30m      # Add time manually
verus time report                # Time report (by task)
verus time report --group label  # Report grouped by label
verus time report --group status # Report grouped by status

Board & Search

verus board                      # Kanban board in terminal
verus search "authentication"    # Full-text search (tasks + docs)
verus search "bug" --type task   # Search tasks only
verus search "api" --type doc    # Search docs only
verus search "auth" --limit 5    # Limit results
verus search --reindex           # Rebuild search index

Configuration

verus config get                 # Show all config
verus config get name            # Get specific value
verus config set name "My App"   # Set value

Models (Semantic Search)

verus model list                 # List available embedding models
verus model download gte-small   # Download a model
verus model path                 # Show model storage directory
verus model remove gte-small     # Remove a downloaded model

Templates

verus template list              # List available templates
verus template run component     # Run template (generates code)

Imports

verus import add <git-url>       # Import from git repo
verus import add <npm-package>   # Import from npm
verus import list                # List imported sources
verus import sync                # Sync all imports (pull latest)
verus import remove <name>       # Remove an import

Skills

verus skill list                 # List all skills (project + built-in)
verus skill install              # Install all built-in skills
verus skill install <name>       # Install specific skill
verus skill sync                 # Sync skills to AI platforms

Sync (Agent Integration)

verus sync agents                # Update AGENTS.md, GEMINI.md, CLAUDE.md
verus sync agents --platform claude  # Sync for specific platform
verus sync mcp                   # Setup MCP in .mcp.json + Claude Code
verus sync mcp --project         # Only create .mcp.json
verus sync mcp --global          # Only setup Claude Code CLI
verus sync skills                # Sync skills from .agent/skills/ to .verus/skills/

Server & Web UI

verus serve                      # Start API server (port 3456)
verus serve -p 8080              # Start on custom port
verus browser                    # Open Web UI (starts server if needed)
verus browser --no-open          # Start server without opening browser
verus browser -p 8080            # Use custom port

MCP Server

verus mcp                        # Start MCP server (stdio transport)
verus mcp --port 3457            # Start MCP server (HTTP SSE transport)
verus mcp --root /path/to/proj   # Explicitly set project root

Utilities

verus version                    # Show version
verus guidelines                 # Show AI agent guidelines
verus guidelines --plain         # Plain text output
verus completion bash            # Generate shell completions
verus completion zsh
verus completion fish

🌐 Web Dashboard

Included in the npm package — no separate install needed.

Pages: Dashboard · Kanban · Tasks · Docs · Templates · Imports · Config

Features: Dark/light mode · ⌘K search · Real-time SSE · Time tracker · Responsive sidebar

🤖 MCP Integration

Verus provides an MCP (Model Context Protocol) server for AI agent integration, allowing tools like Claude Code, Antigravity, Cursor, and others to create/manage tasks, docs, and more.

Stdio Transport (Default)

The most common way to connect — verus init auto-generates .mcp.json:

{
  "mcpServers": {
    "verus": { "command": "verus", "args": ["mcp"] }
  }
}

The MCP server auto-detects the project from the working directory set by your IDE.

HTTP SSE Transport

For multi-process setups or debugging:

verus mcp --port 3457

Then configure your MCP client to connect via SSE to http://localhost:3457/sse.

Available MCP Tools

| Tool | Description | |------|-------------| | create_task | Create a new task | | list_tasks | List tasks with filters | | get_task | Get task by ID | | update_task | Update task fields | | delete_task | Delete a task | | get_board | Get task board by status | | create_doc | Create documentation | | list_docs | List all docs | | get_doc | Get doc by path | | update_doc | Update doc content/metadata | | search | Search tasks and docs | | list_templates | List code templates | | get_template | Get template config | | run_template | Run code generation | | create_template | Create template scaffold | | start_time | Start task timer | | stop_time | Stop task timer | | time_status | Active timers | | add_time | Add time entry | | get_time_report | Time report | | get_config | Get project config | | set_config | Set config value | | validate | Validate project integrity |

Note: verus browser runs the Web UI independently of the MCP service. Web UI logs never interrupt the stdio JSON-RPC connection.

🔧 Development (Local)

Prerequisites

• Go 1.22+ — go version
• Node.js 18+ — node -v

First-time Setup

git clone https://github.com/thanhduy1812/verus.git
cd verus

# Build Go binary + UI → install globally via npm link
make npm-local

Verify:

verus version
verus browser

Fast Iteration

After editing code, rebuild only what changed:

# After Go code changes (~1s)
make dev-go

# After UI changes (~7s)
make dev-ui

No need to npm link again — changes are live immediately.

Full Rebuild

After pulling changes or major updates:

make rebuild

This kills old processes, cleans artifacts, rebuilds UI + Go binary, and re-links npm globally.

Live Dev Mode (Hot Reload)

For frontend development with Vite HMR:

make dev
# API:  http://localhost:3456
# UI:   http://localhost:5173

All Make Targets

make npm-local    # First time: build all + npm link
make rebuild      # Full rebuild: clean + build all + npm link
make dev-go       # Rebuild Go binary only (~1s)
make dev-ui       # Rebuild UI only (~7s)
make dev          # Live dev servers (Go + Vite HMR)
make npm-package  # Build for npm publishing
make release      # Build release binaries (cross-platform)
make clean        # Remove build artifacts
make help         # Show all targets

📂 Project Structure

.verus/                  # Created by `verus init`
├── config.json          # Project config (internal)
├── config.yaml          # Project settings
├── flow.yaml            # Workflow & status definitions
├── tasks/               # Task files (markdown + frontmatter)
├── docs/                # Documentation (markdown)
├── templates/           # Code generation templates
├── skills/              # AI skills (SKILL.md files)
└── search-index/        # FTS5 search index (auto-generated)

.mcp.json                # MCP server config (auto-generated by init)
AGENTS.md                # Agent guidelines (generic)
GEMINI.md                # Antigravity/Gemini rules
CLAUDE.md                # Claude Code rules
.cursorrules             # Cursor rules

📄 License

MIT — see LICENSE for details.