This skill provides a CLI interface for the Caido API, enabling developers to perform HTTP-history-driven testing. It allows users to search history using HTTPQL and execute proxied curl requests that maintain authentication via static configuration files.
By leveraging the official SDK client, the tool streamlines the process of adding match and replace rules and organizing request handoffs into named replay sessions and collections.
Follow the documented setup, then try a first task.
Installs: All skills in caido/skills, installed globally for the selected Claude Code agent. The listed skill path is a bounded mapping, not a complete bundle inventory. · Claude Code
Run this command in a terminal to install the complete bundle globally.
pnpm dlx skills add caido/skills --skill='*' -g
During installation, select Claude Code at the “Which agents do you want to install to?” prompt.
Set your terminal's working directory to ~/.claude/skills/caido-mode, the documented location containing caido-client.ts. Run all remaining terminal commands there.
Install the skill's dependencies in the terminal.
npm install
Create a PAT in Caido Dashboard → Developer → Personal Access Tokens. In the terminal command, replace <your-pat> with that token. This configures authentication for the default instance at http://localhost:8080.
npx tsx caido-client.ts setup <your-pat>
Verify connectivity and retrieval of recent history in the terminal.
npx tsx caido-client.ts health npx tsx caido-client.ts recent --limit 1
Uses caido-mode
Use the caido-mode skill to search existing Caido HTTP history for requests whose path contains /api/ and whose response status is 400–499. Return up to five matches with a brief summary of their paths and status codes.
Claude