CLI Reference

All 17 commands to control your brain.

veris init

Interactive setup wizard. Detects installed AI providers, configures integrations, sets up your LLM for knowledge extraction, and creates the brain database.

$ veris init

veris status

Shows brain health at a glance — initialization state, database status, watcher state, connected providers, and core statistics (nodes, edges, patterns).

$ veris status

veris search

Search the knowledge graph using spreading activation. Finds nodes matching your query and triggers connected memories — the same way thinking about "coffee" activates "morning" and "productivity".

$ veris search "typescript generics"

veris list

Shows recent memory nodes with their importance level, type, content snippet, creation date, and confidence score.

$ veris list
$ veris list --type preference --limit 10

veris hot

Shows the most activated nodes right now and generates a context briefing — the same narrative your AI receives. Useful for understanding what the brain is "thinking about".

$ veris hot
$ veris hot --detail MAXIMUM --topic "auth system"

veris stats

Detailed brain statistics — total nodes, edges, active nodes, patterns, sessions. Includes type breakdown with bar charts, edge type distribution, latest session info, and critical period indicator (shows if your brain has fewer than 20 sessions).

$ veris stats

veris add

Manually add knowledge to your brain. Useful for seeding important facts, preferences, or project context. Automatically links to existing related nodes.

$ veris add "I prefer functional components over class components"
$ veris add "Project uses PostgreSQL" --type fact --importance 0.9

veris forget

Delete specific memories from the knowledge graph. Searches for nodes matching the query and removes them permanently. GDPR-compliant — your right to be forgotten.

$ veris forget "old project name"

veris watcher

Control the background daemon that processes memories, runs consolidation cycles, and keeps the brain alive. Runs on HTTP port 7899.

$ veris watcher start   # Start the daemon
$ veris watcher stop    # Stop the daemon
$ veris watcher status  # Check status + LLM connection

veris consolidate

Trigger a manual consolidation cycle. Normally runs automatically every 6 hours. Prunes weak edges, promotes important nodes, merges duplicates, finds creative connections (REM-style), detects knowledge gaps, and distills clusters into schemas.

$ veris consolidate
Edges pruned:         12
Nodes promoted:        3
Nodes merged:          2
Patterns created:      1
Dream edges:           4
Duration:          2.3s

veris verify

Run a 6-step brain integrity check. Validates config, database (15 tables), core nodes, hooks, signal strength, and spreading activation. Useful for debugging or after updates.

$ veris verify
[1/6] Config .............. OK
[2/6] Database (15 tables)  OK
[3/6] Core Nodes .......... OK
[4/6] Hooks (4 events) .... OK
[5/6] Signal Strength ..... OK
[6/6] Spreading Activation  OK

veris snapshot

View the brain's growth over time. Shows a timeline of snapshots with node count, edge count, patterns, and top topics at each point.

$ veris snapshot
$ veris snapshot --count 20

veris dashboard

Launch the interactive 3D brain visualization in your browser. Shows the knowledge graph as a force-directed network with real-time activation levels, brain health metrics, and session history.

$ veris dashboard
$ veris dashboard --port 8080

veris embed

Manage vector embeddings for hybrid search (spreading activation + semantic similarity). Uses text-embedding-3-small.

$ veris embed status     # Show embedding coverage %
$ veris embed backfill   # Create embeddings for unembedded nodes
$ veris embed backfill --batch 50

veris detect

Scan your system for installed AI coding assistants. Shows which providers are detected and their config file paths.

$ veris detect
  ✓ Claude Code   ~/.claude/settings.json
  ✓ Cursor        ~/.cursor/mcp.json
  ✗ Windsurf
  ✗ Codex CLI

  2 of 13 providers found

veris mcp

Register or remove the MCP server for any supported provider. Useful for manual setup or troubleshooting after veris init.

$ veris mcp install                          # Default: claude-code
$ veris mcp install --provider cursor        # For Cursor
$ veris mcp uninstall --provider windsurf   # Remove from Windsurf

veris site

Open the Veris website in your default browser.

$ veris site