CLI Overview

The NestWeaver CLI is the primary interface for indexing codebases, querying the knowledge graph, and managing brain vaults. All commands route through a background daemon by default, enabling concurrent access from multiple AI tools without lock contention. The daemon auto-starts on first use and exits after 1 hour of inactivity.

Global flags

These flags work on every command.

Flag	Short	Description
--stats		Print timing and statistics after operations
--quiet	-q	Suppress non-essential output
--verbose	-v	Show additional detail (e.g. UIDs)
--no-color		Disable colored output
--plain		Alias for --no-color
--no-embed		Disable semantic embedding for this invocation
--db <path>		Path to the database file (env: NESTWEAVER_DB, default: ./nestweaver.lbug)

Exit codes

Code	Meaning
0	Success
1	Error
2	Not found
3	Ambiguous (multiple matches)
4	Unauthorized
5	Unavailable

Command groups

• Indexing & Watch — Parse repos, live re-index, manage indexed sources
• Context & Search — PPR-ranked context, full-text search, symbol lookup, regex search
• Impact & Analysis — Blast radius, PR impact, dead code, hubs, bridges, graph export
• Brain Commands — Vault management, unified search across code and notes
• Multi-Repo & Projects — Cross-repo references, named projects, feature bundles

Output formats

All commands support --json for machine-readable output. Human-readable table output is the default when stdout is a terminal.

Getting help

nestweaver --help

List all available commands. For details on any specific command:

nestweaver <command> --help