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.

Start here

Run Caplets without a global install:

npx caplets setup
npx caplets install spiritledsoftware/caplets osv

Or install it globally:

npm install -g caplets
caplets setup
caplets install spiritledsoftware/caplets osv

OSV is the first recommended Caplet because it is public and does not need auth. After setup, ask your agent to use the OSV capability to check a package version.

What to read next

• Install - set up the CLI and agent connection.
• Code Mode - learn the default agent workflow.
• Configuration - configure user and project Caplets.
• Capabilities - add MCP, OpenAPI, GraphQL, HTTP, CLI, and shared Caplets.
• Agent integrations - use Codex, Claude, OpenCode, and Pi.
• Remote attach - connect agents to a remote Caplets runtime.
• Troubleshooting - check config, auth, and runtime issues.