Quick Start (CLI)

rpctl is Rohrpost’s command-line client — useful for scripting ingestion, querying recall directly, running admin tasks, and processing Claude Code lifecycle hooks. Most day-to-day use goes through an MCP client instead (see the Docker quick start), but rpctl is there when you want direct terminal access or want to script against the gateway.

Prerequisites

  • A running Rohrpost gateway — either the Docker Compose quick start locally, or the managed gateway at app.rohrpost.io
  • Rust 1.95+ (to build rpctl from source — it isn’t published to crates.io, so cargo install won’t find it)

Build the CLI

git clone https://codeberg.org/ftieben/rohrpost.io
cd rohrpost.io
cargo build --release --bin rpctl
# binary is at target/release/rpctl

Point it at your gateway via an environment variable (or --gateway on each command):

export ROHRPOST_GATEWAY_URL=http://localhost:7878   # or https://app.rohrpost.io
export ROHRPOST_API_KEY=rp_your_api_key             # required for managed; optional for an unauthenticated self-hosted instance

Ingest your first capsule

rpctl ingest --tenant my-project --kind note <<< "Our auth uses JWT with RS256 signing."

--kind is one of prompt, response, tool_call, diff, error, or note; content comes from stdin, or pass --file path/to/notes.txt instead.

Query the knowledge base

rpctl recall --tenant my-project "how does auth work" --top-k 5

The result is a packed markdown brief — the same shape an MCP client gets back from rohrpost_recall — ready to paste into your next prompt.

Next steps

  • Learn about Capsule Architecture to understand how ingestion, distillation, and recall fit together
  • See the MCP Server docs for the full tool reference if you’re wiring up an AI assistant instead of using the CLI directly