Skip to content
LoomBrain LoomBrain LoomBrain

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

Section titled “Installation”

npm (all platforms)

Terminal window
npm install -g @loombrain/cli

Homebrew (macOS)

Terminal window
brew install amentistudio/tap/lb

Verify the installation:

Terminal window
lb --version

Commands

Section titled “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

Section titled “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

Section titled “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

Section titled “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.