Developer interfaces

CLI Finder Registry API and CLI

Search agent-ready tools, inspect evidence, and generate skills, policies, or machine-readable manifests through the public HTTP API or repository CLI.

Choose an Interface

The API and CLI read the same registry. Server integrations can call HTTP directly, while terminal workflows can use the CLI with stable output and exit codes.

Registry API

Unauthenticated, read-only JSON endpoints with CORS, search filters, tool details, and artifact generation.

Fits servers, CI, and custom agent integrations
Successful responses use a code/message/data envelope
The public registry manifest supports bulk sync

Read the API reference

CLI

A zero-runtime-dependency Node.js client for search, inspection, and writing generated artifacts to stdout.

Fits terminals, scripts, and agent shells
Human-readable output by default and JSON on request
Stable exit codes separate usage, not-found, network, and API errors

Read the CLI reference

Start with One Search

The HTTP example calls the live registry directly. The CLI is not published to npm; run the CLI example from a checkout of this repository.

Search over HTTP

curl

curl --get 'https://clifinder.net/api/registry/tools' \
  --data-urlencode 'q=review pull requests' \
  --data-urlencode 'agent=codex' \
  --data-urlencode 'risk=R0' \
  --data-urlencode 'limit=5'

Run the CLI from a Checkout

shell

npm exec --package ./packages/cli -- clifinder search \
  "review pull requests" --agent codex --risk R0 --limit 5

CLI distribution status

packages/cli is currently marked private. Do not use npm install clifinder or assume a public npm package exists. From the repository root, use the npm exec command above or run node packages/cli/bin/clifinder.mjs directly.

Machine-Readable Entry Points

Use focused endpoints for on-demand reads or sync the whole registry through the manifest. Every link below is a directly accessible URL.

Entry point	Format	Purpose
/api/registry/tools	JSON envelope	Search all tools and apply agent, environment, risk, output, category, and evidence filters.
/api/registry/tools/:slug	JSON envelope	Read one tool with installation, output, commands, risk, readiness, and evidence.
/api/registry/use-cases	JSON envelope	Read the bilingual agent-workflow list with tools, steps, approval points, rollback, and evidence.
/api/registry/use-cases/:slug	JSON envelope	Read one complete workflow by slug.
/api/registry/artifacts/:slug	JSON envelope	Generate a skill, policy, manifest, or automation file by type, agent, and mode.
/registry.json	JSON manifest	Returns the whole registry without the API envelope for caching and offline indexing.

Open a search response Open a tool response Open a use-case response Open the full registry manifest