Quickstart

Install

npm i -g @amxv/agentscript
agentscript --help

For local development from a clone:

make build
./dist/agentscript --help

Open a transcript

agentscript open ~/.claude/projects/<project>/<session>.jsonl
agentscript open ~/.codex/sessions/<year>/<month>/<day>/<session>.jsonl

open is the main entry point. Running agentscript by itself shows help instead of opening anything.

Open a recent transcript

agentscript open --latest 1
agentscript list --latest 20

By default, agentscript discovers transcripts in:

~/.claude/projects
~/.codex/sessions

Use a custom discovery root when needed:

agentscript list --roots ./fixtures,~/Desktop/transcripts

Hide noisy blocks

agentscript open transcript.jsonl --hide-thinking
agentscript open transcript.jsonl --messages-only
agentscript open transcript.jsonl --profile compact

Slice and export context

agentscript slice transcript.jsonl 0:100 --format md --out context.md
agentscript export transcript.jsonl --format html --out transcript.html

Inspect what happened

agentscript commands transcript.jsonl --failed --with-output
agentscript changes transcript.jsonl
agentscript activity transcript.jsonl