Recording

The MCP recording proxy

reelier mcp --wrapstarts an MCP server on stdio that re-exposes an existing MCP server’s tools 1:1 — same names, same descriptions, same input schemas — and adds three control tools your agent calls to capture a lossless trace of what it actually did. The live path is never modified: redaction only ever touches the copy written to the trace file, never what your agent actually receives back.

Install it in front of an existing MCP server (Claude Code example):

claude mcp add reelier -- npx reelier mcp --wrap "npx -y @your/mcp-server"

Wrap more than one downstream server by repeating --wrap.

Recording a session

Tell your agent “record yourself doing this,” and it will:

1. Call reelier_start_recording {name} — opens .reelier/traces/<name>-<n>.jsonl (an existing trace is never overwritten).
2. Call reelier_note {text} before each logical step to narrate intent.
3. Work normally — every wrapped tool call and its result is appended, in order.
4. Call reelier_stop_recording {} — returns the trace path and how many calls were captured.

Then compile it into a skill:

reelier compile .reelier/traces/<name>-1.jsonl

The zero-setup demo path

No MCP config detected? reelier initfalls back to a real, live demo: fetching this package’s own npm registry metadata and homepage. It’s a real HTTP-tool workflow, recorded, compiled, and replayed the same way — a way to see the whole loop with nothing set up.

reelier init

Redaction (trace-write time only)

Recording deep-walks each call’s args and result before writing them to the trace file — never on the live path back to your agent:

• REELIER_REDACT— comma-separated env var names; any occurrence of those vars’ values (6+ chars) is replaced.
• Always on: sk--shaped tokens and Bearer ... headers.
• Always on: a 32+-char hex string in a field named like token/secret/key/password/authorization.

This is deliberately conservative — it can miss secrets in unnamed fields or unusual shapes. Treat trace files as sensitive until you’ve verified redaction covers what you’re wrapping.