velocitybrain-client 1.0.1

Open-source CLI, SDK, and MCP bridge for the hosted VelocityBrain coding-agent reuse API

VelocityBrain Client

Open-source CLI, Python SDK, and MCP bridge for the hosted VelocityBrain API.

Scope

This package contains the public distribution layer only:

• Python client
• hosted CLI
• MCP bridge
• integration examples

This package does not contain the hosted backend, ranking logic, reuse engine, dashboard, or private operational tooling.

Install

pip install velocitybrain-client

For local development:

pip install -e ".[dev]"

Configure

Set your API key with an environment variable:

export VELOCITYBRAIN_API_KEY="vb_live_xxx"

Or save it with the CLI:

velocitybrain config --set-key vb_live_xxx

Optional:

velocitybrain config --set-key vb_live_xxx --base-url https://your-hosted-base-url

The default hosted base URL is https://velocity.linkitapp.in.

CLI

The public CLI exposes three commands:

• velocitybrain run <task>
• velocitybrain status
• velocitybrain config --set-key <key>

Examples:

velocitybrain run "Which files should I edit to change hosted auth safely?"
velocitybrain run --json --response-style lite "Summarize the API key flow."
velocitybrain status

run returns a normalized payload with:

• result
• reused
• reuse_confidence
• tokens_saved
• percent_saved

Python SDK

from velocitybrain_client import VelocityBrainClient

with VelocityBrainClient(api_key="vb_live_xxx") as client:
    result = client.run(
        "Map the hosted auth and API key flow in this repo.",
        response_style="lite",
    )
    print(result)

    usage = client.get_usage_stats()
    print(usage)

MCP Bridge

Start the MCP bridge:

velocitybrain-mcp

The public MCP bridge exposes two tools:

• run_agent
• usage

It requires VELOCITYBRAIN_API_KEY to be set in the environment before launch.

Example config files are available in:

• integrations/mcp/mcpServers.velocitybrain.json
• integrations/openclaw/mcpServers.json
• integrations/hermes/config.velocitybrain.yaml
• integrations/claude/setup.sh

Hosted API Surface

The public client is limited to these hosted endpoints:

• POST /v1/run
• GET /v1/usage

Development Checks

Run the public package checks before release:

pytest
python scripts/check_public_boundary.py
python -m build

The boundary check ensures the public package does not import private runtime modules from the main product codebase.