Skip to content
CapletsCaplets Docs

Caplets

Caplets wraps MCP servers, APIs, and commands into focused capabilities for coding agents. Code Mode is the default surface: each configured backend becomes a typed caplets.<id> handle that an agent can inspect, search, call, filter, and summarize in one workflow.

Use Caplets with Codex, Claude, OpenCode, Pi, or any MCP client that can launch a local stdio server.

Quick Start

Section titled “Quick Start”

Run a known-good no-auth setup first. OSV is public, so it is the fastest way to prove your agent can see and call a Caplet.

Terminal window
npx caplets setup
npx caplets install spiritledsoftware/caplets osv
npx caplets doctor

Or install it globally:

Terminal window
npm install -g caplets
caplets setup
caplets install spiritledsoftware/caplets osv
caplets doctor

caplets setup is daemon-first: it initializes Caplets config, starts or reuses the local Caplets daemon, and configures your agent as a thin caplets attach <local-daemon-url> or native client. The daemon owns backend execution and environment passthrough, so agent configs do not need secrets or provider-specific environment values.

doctor should identify the active Caplets config path and report the checks it can run for your configured integrations. Fix any failed check before testing through an agent.

Then ask your agent to use Caplets Code Mode to query OSV for npm package react@18.2.0, returning the package, version, vulnerability count, and advisory IDs as compact JSON.

A successful agent run should use the visible caplets__code_mode tool and inspect an OSV handle such as caplets.osv. If the agent cannot see that tool, go to Troubleshooting.

First success shape

Section titled “First success shape”

The exact OSV data can change over time, but the result should have this shape:

{
  "package": "react",
  "version": "18.2.0",
  "vulnerabilityCount": 0,
  "advisoryIds": []
}

If the package has advisories, vulnerabilityCount should increase and advisoryIds should contain the OSV identifiers the agent found.

Section titled “What to read next”