Install
- CLI
- Python
- TypeScript
- Web/WASM
- Rust
- Cargo CLI
rkat, rkat-rpc,
rkat-rest and rkat-mcp. Without Homebrew, use the release archives
(see Linux without Homebrew).Linux without Homebrew
Each GitHub release has one archive per binary per target, pluschecksums.sha256. Download the binaries you need, verify them, and put
them on your PATH:
rkat-rest or rkat-mcp to the loops if you need them. rkat-rpc is
the binary the Python and TypeScript SDKs drive. The Linux binaries need
glibc 2.31 or later; musl distributions such as Alpine are not supported
(see Linux glibc floor).
Configure One Provider
The fastest path is a dedicated Meerkat environment variable:Run A First Session
- CLI
- Python
- TypeScript
With the OpenAI variable above:With another provider, select a matching model:
rkat-rpc; the CLI constructs the same runtime-backed
session in-process.
Share State Across Surfaces
CLI commands derive a stable workspace realm by default. A bare RPC/REST/MCP server or SDK connection creates a fresh isolated realm. Pass one explicit ID when several processes should see the same sessions and config:Add An MCP Server
--wait-for-mcp makes the first prompt wait for configured servers.
For a remote streamable-HTTP server that signs in with OAuth (replace the
example URL with the service you use). discover binds the account the
service verifies at the first login; use --oauth-account-selection unverified
only for a server that cannot prove an account:
Bound One Run
--max-tokenscaps LLM output per turn.--max-tool-callsbounds tool use for the run.--max-durationbounds the run’s agent lifetime; a deadline is a hard terminal failure rather than a warning.
Add Built-In Capabilities
Thefull preset enables the product CLI’s broad tool composition, including
shell, MCP, skills, comms, schedules, WorkGraph, and mob orchestration where
compiled:
--allow-tool and --block-tool for a narrower first-turn scope. Shell
access and other effectful tools should be granted deliberately.
Next Steps
- Examples gallery - choose a maintained workflow
- Sessions example - continue a multi-turn conversation
- Auth - configure bindings and OAuth
- Providers - inspect models and parameters
- Rust SDK - embed runtime-backed sessions
- Python SDK - build from Python
- TypeScript SDK - build from Node.js
- Web/WASM - run in the browser
