kindred-cli

kindred-cli

Kindred CLI — run dashboard operations from the terminal for humans and AI agents.

Install

npm:

npm install -g kindred-cli
# or:
npx kindred-cli --help

Requires Node.js 18+.

Monorepo (development):

pnpm install
pnpm build:cli
pnpm kindred --help

Authentication

Set your API key via environment variable (recommended for agents):

export KINDRED_API_KEY="kindred_api_…"

Or save to ~/.config/kindred/config.json:

kindred auth login --api-key kindred_api_…

Optional:

export KINDRED_API_URL="https://api.usekindred.dev"
export KINDRED_CONSOLE_URL="https://app.usekindred.dev"

Agent usage

Use --json for discovery commands (agents list, sessions list, etc.). Prefer human output for replay run.

kindred sessions list --agent-id agt_… --json
kindred replay run <sessionId> --target-url https://agent.example.com/replay --runs 3

Exit codes for replay run:

Code	Meaning
0	All runs matched
2	Divergence detected
1	API / transport error

Commands

See skills/kindred-cli/reference.md for the full command reference.

Primary namespaces: auth, config, agents, sessions, search, replay, clustering, expectations, usage, api-key, runs, langfuse.

Publishing (maintainers)

npm login   # as usekindred
./scripts/publish-cli.sh --dry-run
NPM_OTP=123456 ./scripts/publish-cli.sh

Publishes @usekindred/client then kindred-cli (monorepo packages stay @kindred/*). Use NPM_OTP when 2FA is enabled.

License

MIT