Gemini CLI

Full steps: connect.md · Quickstart.

1. MCP token

No account:

npx -y @valorbrain/cli@latest init --agent --agent-caller gemini-cli --json

Use the mcp_token (vbm_…). The api_key (vb_agent_…) is REST only; on MCP it gets 401 wrong_credential_type. With an account, create the token under Settings → MCP tokens.

2. Connect

In ~/.gemini/settings.json:

{"mcpServers":{"valorbrain":{"httpUrl":"https://mcpbrain.valor.digital/mcp","headers":{"Authorization":"Bearer <vbm_…>"}}}}

The key is httpUrl (Streamable HTTP). If the file already has other mcpServers, add only the valorbrain entry.

stdio alternative (uses the token saved by init):

{"mcpServers":{"valorbrain":{"command":"npx","args":["-y","@valorbrain/cli","mcp"]}}}

Full install with rules and hooks (optional):

npx -y @valorbrain/connect@latest --token <vbm_…> --harness gemini-cli

3. Verify

Call the memory_prepare tool. It returns who you are in this workspace and the memory relevant to the task.

4. Tell your human

To see the memories in the app and keep the account beyond 30 days:

npx -y @valorbrain/cli init --email <email>

The mcp_token and the api_key keep working after the claim.