What is IntentLoop?

IntentLoop is a Rust CLI tool for recording AI agent coding sessions locally. It wraps any agent command — GitHub Copilot, custom LLM prompts, or shell scripts — and captures the full session: intent metadata, terminal output, structured events, conversation turns, and reports.

Everything stays on your machine. No cloud, no telemetry, no accounts.

Session recording

Use il run to record any agent. The command executes in a real PTY, so arrow keys, TUI interfaces, and full interactive behavior are preserved exactly. Every keystroke and every byte of output is captured.

# Record real agents
il run cursor
il run claude

# Your environment (API keys, etc.) is inherited automatically
ANTHROPIC_API_KEY=sk-... il run claude

Inspect sessions

After recording, il last (or bare il show) shows metadata and proves that the full conversation with the LLM/agent was captured.

$ il last

Session: 019e6c0a-8f2b-...
Status: succeeded
Started: 2026-05-30T15:12:33
Command: cursor
Thought events: 124

Conversation: memmap_fs:sessions/.../conversation (18.7 KiB)
Report:         memmap_fs:sessions/.../report (2.1 KiB)
Ring buffer:    memmap_fs:sessions/.../ring (67 KiB)

# Read the actual back-and-forth with the LLM
il dump conversation

Local storage

All recordings live exclusively in ~/.intentloop/ (or $INTENTLOOP_HOME) inside a memmap_fs database. No plain-text report.md or *.jsonl files are written by default.

Inspect and export content with the normal il commands:

il last                  # most recent session
il dump report           # export the Markdown report
il dump conversation     # structured turns
il dump stdout -o out.txt

Commands