Skip to content

feat(web-security): add caido-mode skill (Caido TypeScript SDK / caido-ts) - #119

Merged
GangGreenTemperTatum merged 1 commit into
mainfrom
ads/eng-7959-update-caido-mode-skill-for-caido-ts-sdk
Aug 13, 2026
Merged

feat(web-security): add caido-mode skill (Caido TypeScript SDK / caido-ts)#119
GangGreenTemperTatum merged 1 commit into
mainfrom
ads/eng-7959-update-caido-mode-skill-for-caido-ts-sdk

Conversation

@GangGreenTemperTatum

Copy link
Copy Markdown
Contributor

Summary

Adds the caido-mode skill — the Caido TypeScript SDK CLI (@caido/sdk-client, a.k.a. caido-ts) — to the web-security capability. This is the TS companion to our existing Python caido-sdk skill, vendored from the upstream caido/skills PR #22 (merged to their main, source commit 5bb27a9).

It becomes a third independent Caido surface alongside:

  • caido-sdk — direct Python caido-sdk-client calls
  • caido-proxy / caido-go — MCP tool surface

All three target the same instance via CAIDO_URL/CAIDO_PAT and do not interfere: caido-mode caches its own auth in ~/.claude/config/secrets.json, separate from the ~/.caido-mcp/token.json used by the Python SDK skill and the MCP servers.

What caido-mode adds

Curl-through-Caido testing (auth cached into reusable static curl configs), Match & Replace (tamper) rules, replay-session/collection handoffs, findings/scopes/filters/environments, and HTTPQL history search — write-side automation the other two skills don't cover.

Changes

  • Vendor skills/caido-mode/ (tsx CLI + lib/ + test/) from caido/skills@5bb27a9. node_modules is gitignored.
  • SKILL.md adapted for the dreadnode runtime: bootstrap from the skill dir, non-interference section, runtime-provided CAIDO_URL/CAIDO_PAT.
  • scripts/install_tools.sh: npm install the skill's node_modules at provision time (after Node setup).
  • docker/Dockerfile.runtime: pre-install tsx globally + document the dep.
  • capability.yaml: add caido-mode check, update description, bump 1.6.0 → 1.7.0.

Validation

  • 68/68 vendored skill unit tests pass (npm test).
  • just validate green for web-security@1.7.0 (skills=79); new caido-mode check passes. Pre-existing caido-cli/burp check warnings are unrelated (binaries absent on the dev host).
  • pre-commit (check-yaml, gitleaks, eof/trailing-whitespace) clean.

Node deps are installed at provision time; nothing baked into the image (skill dir mounts at runtime).

…o-ts)

Vendor the upstream caido/skills caido-mode skill (merged PR #22,
@caido/sdk-client / caido-ts v0.4.0) into web-security as a third,
independent Caido surface alongside the Python caido-sdk skill and the
caido-proxy / caido-go MCP servers.

- Vendor skills/caido-mode/ (tsx CLI + lib + tests) from caido/skills@5bb27a9
- Adapt SKILL.md for the dreadnode runtime: bootstrap from the skill dir,
  document non-interference with caido-sdk/caido-proxy (separate auth
  cache), and note runtime-provided CAIDO_URL/CAIDO_PAT
- install_tools.sh: npm install the skill's node_modules at provision time
- Dockerfile.runtime: pre-install tsx globally; document the caido-mode dep
- capability.yaml: add caido-mode check, update description, bump to 1.7.0

Node deps (node_modules) are gitignored and installed at provision time.
All 68 skill unit tests pass; just validate is green for web-security.
@GangGreenTemperTatum
GangGreenTemperTatum merged commit 9a1f8ab into main Aug 13, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant