CLI

@valorbrain/cli: agent-native memory from the shell. Zero dependencies, Node 18+.

Package: @valorbrain/cli 0.1.0. Alias for the MCP stdio proxy: @valorbrain/connect.

npx @valorbrain/cli help --json

That JSON is the contract. If a blog post or README names a subcommand that is not in this object, the command does not exist.

Global flags

Flag	Alias	Meaning
`--json`	`--agent`	Single JSON object on stdout, no colour, no spinner
`--key`		API key override (otherwise `~/.valorbrain/config.json`)
`--url`		REST base URL override

Defaults:

Creates a shadow tenant and a vb_agent_ key. See Quickstart.

Binds the existing key to an email via OTP. The key does not change.

Idempotent agent_caller backfill. Self-declared, never sniffed.

Stores a document.

Flag	Maps to
`--collection <name>`	`collection` (default depends on server; pass one if you care)
`--title <t>`	`title`
`--type <t>`	content type (`decision`, `observation`, `problem`, `lesson`, `milestone`, `handoff`, `note`)

Calls POST /documents. Body is stored verbatim — no translation.

Flag	Meaning
`--collection <name>`	Restrict to one collection
`--mode auto\|keyword\|semantic\|hybrid`	Retrieval mode

Calls POST /search with compact: true.

GET /collections.

Local config plus GET /health on the REST host.

Stdio ↔ HTTP MCP proxy. @valorbrain/connect is this command as its own package, so stdio clients can run:

{
  "mcpServers": {
    "valorbrain": {
      "command": "npx",
      "args": ["-y", "@valorbrain/connect", "--token", "vbm_…"]
    }
  }
}

The MCP token prefix is vbm_, not vb_agent_. Mix them up and the MCP host will reject you.

Human text, or the machine surface.

npx @valorbrain/cli --url https://your-engine.example.com init --agent

There is no public one-line installer for the engine. On-prem is an Enterprise plan — accompanied deployment by our team on your network.