CLI

blenau is an agent-first command-line client for the Blenau API: search, repos, docs, ingest, section edits and asset uploads. Every command supports --json, and --agent-manifest emits the full command contract for tooling discovery.

Install

Download a release (recommended)

Grab the archive for your platform from the latest release, extract the blenau binary and put it on your PATH.

Prebuilt binaries: macOS (Intel & Apple Silicon), Linux (amd64 & arm64), Windows (amd64).

With Go

go install github.com/getblenau/cli@latest

This builds the latest released version. Note: go install names the binary after the module path (cli); rename it to blenau if you want that command name. (The release archives are already named blenau.)

Log in

blenau login --token blenau_tk_xxxxxxxx

The token (same format as the MCP token) is saved to a local config file with 0600 permissions. You can also set BLENAU_API_TOKEN (and BLENAU_API_URL) via environment variables.

Commands

Command	What it does
blenau search <query>	Semantic search across your workspace.
blenau repos	List connected repos and their path_prefix.
blenau docs	List / inspect documents.
blenau ingest --path <p> --title <t>	Create a document (content from --content-file or stdin).
blenau edit-section …	Edit a section with optimistic locking.
blenau assets upload <file> --doc <path>	Upload an image/file to a doc — see Images & assets.
blenau audit	Audit the cross-link graph.

Run blenau <command> --help for full flags, or blenau --agent-manifest for a machine-readable contract of the whole CLI surface.

Output

• Human-readable by default in a terminal; JSON when piped or with --json.
• Output is UTF-8 NFC on Linux, macOS and Windows.