kirocc: Skill for Claude Code

kiro-capture

Capture kiro-cli HTTPS traffic with mitmdump and generate analysis reports.

Phase Detection

On invocation, find the latest session under /tmp/kiro-capture/:

LATEST=$(ls -dt /tmp/kiro-capture/*/ 2>/dev/null | head -1)
if [ -n "$LATEST" ] && [ -f "${LATEST}state.json" ]; then
  cat "${LATEST}state.json"
fi

Decision logic:

• state.json exists with "status": "capturing":
  • Check PID with kill -0 <pid>
  • PID alive → ask user: "Capture in progress. Stop and analyze?" If yes → Phase 2
  • PID dead → tell user "mitmdump already stopped. Analyzing log." → Phase 2
• state.json exists with "status": "completed" or "status": "analyzing" → ask user: "Previous capture is done. Start a new capture?"
• No state.json or empty directory → Phase 1

Phase 1: Setup

Step 1 — Check prerequisites

which mitmdump

If not found:

brew install mitmproxy

Check CA certificate:

ls ~/.mitmproxy/mitmproxy-ca-cert.pem

If missing, run mitmdump once to generate it:

mitmdump --set flow_detail=0 &
MITM_PID=$!
sleep 2
kill $MITM_PID 2>/dev/null
wait $MITM_PID 2>/dev/null

Step 2 — Check port availability

lsof -i :8080 -t 2>/dev/null

If port 8080 is in use, try 8081, 8082, ... until a free port is found.

Step 3 — Create session directory

TIMESTAMP=$(date +%Y%m%d_%H%M%S)
SESSION_DIR="/tmp/kiro-capture/${TIMESTAMP}"
mkdir -p "$SESSION_DIR"

Step 4 — Start mitmdump

mitmdump -p $PORT --set flow_detail=3 >"${SESSION_DIR}/raw.log" 2>&1 &
MITM_PID=$!
sleep 1
kill -0 $MITM_PID 2>/dev/null && echo "OK" || echo "FAILED"

Step 5 — Save state.json

Write to ${SESSION_DIR}/state.json:

{
  "status": "capturing",
  "pid": <MITM_PID>,
  "port": <PORT>,
  "session_dir": "<SESSION_DIR>",
  "started_at": "<ISO8601>"
}

Step 6 — Output kiro-cli launch command

Tell the user:

"mitmdump is running on port {PORT}. Run the following command in a separate terminal to start kiro-cli through the proxy: