CLI

lb is the LoomBrain command-line tool. It provides terminal-first access to your knowledge graph: capture content, search nodes, manage PARA structure, and inspect graph health — all from your shell.

Installation

npm (all platforms)

npm install -g @loombrain/cli

Homebrew (macOS)

brew install amentistudio/tap/lb

Verify the installation:

lb --version

Commands

Command	Description
lb login	Authenticate via browser OAuth
lb capture	Capture a URL, file, note, or stdin content
lb search	Search your knowledge graph
lb context	Get ranked context nodes for a topic within a PARA scope
lb tree	Browse your PARA structure
lb health	Show graph health metrics
lb add	Add a plain-text node directly
lb related	Show 1-hop graph neighbors for a node
lb para	Create, archive, or unarchive PARA items
lb retag	Update PARA tags on a node

Global options

These options are accepted by every command.

Option	Description
--json	Output raw JSON instead of formatted text. Useful for scripting.
--api-url <url>	Override the API base URL. Defaults to https://api.loombrain.com.

Environment variables

Variable	Description
LB_TOKEN	API key for non-interactive auth. When set, lb login is not required. Generate keys in dashboard Settings.
LB_API_URL	API base URL override. Equivalent to passing --api-url on every command.
NO_UPDATE_NOTIFIER=1	Suppress update notifications.

Update notifications

lb checks the npm registry for a newer version on startup. The check result is cached for 24 hours, so it does not add latency on repeated invocations.

When an update is available, a notice is printed below command output:

Update available: 1.2.0 → 1.4.0
Run: npm update -g @loombrain/cli

Notifications are automatically suppressed when:

• NO_UPDATE_NOTIFIER=1 is set
• CI=true is set
• stdout is not a TTY (e.g., in a pipe)

See Upgrade for details on the three-layer version enforcement system.