Developer CLI
Browse, list, and rate Kite agent services from your terminal.
kitedir is the developer-facing client for the
Kite Service Directory.
Search the catalog, pull a provider's signed descriptor, submit a new listing,
issue agent tokens via the device-flow, and report usage outcomes — all without leaving
your shell.
# 1. Install the latest release $ curl -fsSL https://cli.dir.kitepass.xyz/install.sh | sh # 2. Point the CLI at the directory $ kitedir config set api_base https://dir.kitepass.xyz # 3. Search the public catalog $ kitedir search "scrape" # 4. Fetch a provider's signed descriptor $ kitedir descriptor get firecrawl # 5. Sign in via device flow + report a call outcome $ kitedir login $ kitedir usage report firecrawl --outcome success --latency-ms 412
Install
One curl, three platforms.
The install script detects your OS / architecture and pulls the right release archive from GitHub. The release is tagged vX.Y.Z-<short-sha> on every push to main, so a fresh install always tracks HEAD.
Default install
Lands the binary in ~/.local/bin/kitedir. Add it to $PATH if it isn't already.
$ curl -fsSL https://cli.dir.kitepass.xyz/install.sh | sh
Pin a version / change the install path
Override with environment variables before piping into sh.
$ KITEDIR_VERSION=v0.1.0-abcd1ef \
KITEDIR_INSTALL_DIR=/usr/local/bin \
curl -fsSL https://cli.dir.kitepass.xyz/install.sh | sh
Also published as raw archives on the
GitHub Releases
page. Each release ships per-platform .tar.gz archives plus a SHA-256 checksum file.
Usage
What kitedir does for you.
Discover
Anonymous catalog read. Search by capability tag, filter by state / visibility, dump the public Markdown export.
Verify
Pull a provider's ServiceDescriptor, check the Ed25519 signature against the published JWK, inspect endpoints + accepted payment protocols.
Submit
List a new provider. Optional endpoint + payment-protocol editor; manager review approves and publishes.
Authenticate
Magic-link or passkey login, RFC 8628 device-flow for headless agent runtimes, scoped agent tokens.
Report
Send post-call usage-events (success / failure / timeout / latency) so the directory can publish a real reputation score.
Inspect
Read your sessions, agent tokens, comments and ratings, the audit chain head, descriptor freshness.
Commands
Reference at a glance.
| Command | What it does |
|---|---|
kitedir config set api_base <url> | Persist the directory base URL (default https://dir.kitepass.xyz). |
kitedir search <query> | Search providers by name / tag. |
kitedir provider get <id> | Fetch a provider's metadata + endpoints. |
kitedir descriptor get <id> | Fetch the current signed descriptor + verify locally. |
kitedir login | Magic-link login, opens browser, persists session. |
kitedir submit <file.json> | Submit a provider draft for manager review. |
kitedir token issue --scope read | Walk the device-flow, hand back a scoped agent token. |
kitedir usage report <id> --outcome <...> | Post a usage outcome that feeds the reputation summary. |
kitedir reputation get <id> | Print the 7d / 30d / 90d reputation snapshot. |
Run kitedir --help on a fresh install for the canonical command list, including any flags this page hasn't been updated for yet.