agent-transit
/agent-transit
A transit map for your coding-agent sessions. Use when the user wants to visualize one Claude Code, Codex CLI, or Cursor coding-agent session as a subway map of tool calls.
- Author
- israelvicars ↗
- Repository
- transit ↗
- Licence
- MIT
- Last repository change
- 20.10.2026
Assessment and security
- Files in this package
- 52
- Scripts
- 39
- HTML comments
- 1
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 20.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 39 scripts in this package. Review them before installing, as Claude may execute them.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
Scripts: core/adapters.mjs, core/build.mjs, core/cli.mjs, core/export.mjs, core/fsguard.mjs, core/gaps.mjs, core/render-frames.mjs, core/render.mjs, core/scrub.mjs, core/setup.mjs, core/still.mjs, core/tools.mjs, core/verdict.mjs, core/verify.mjs, core/vocab.mjs, src/agent-transit/adapters/normalize-agent.mjs, src/agent-transit/samples/make-agent-samples.mjs, src/agent-transit/scripts/export-cursor.mjs, sr
What it does and when to use it
A transit map for your coding-agent sessions. Use when the user wants to visualize one Claude Code, Codex CLI, or Cursor coding-agent session as a subway map of tool calls.
Original author description
A transit map for your coding-agent sessions. Use when the user wants to visualize one Claude Code, Codex CLI, or Cursor coding-agent session as a subway map of tool calls.
How it works
- Where things are
- Steps
- Rules
SKILL.md preview
--- name: agent-transit description: A transit map for your coding-agent sessions. Use when the user wants to visualize one Claude Code, Codex CLI, or Cursor coding-agent session as a subway map of tool calls. --- <!-- Generated from src/agent-transit/SKILL.md; do not edit --> # Agent Transit A local subway map for one AI coding-agent session: tool families are lines and tool calls are stations. 🔒 Session logs can contain prompts, source code, command output, credentials, and other secrets. This skill is default-deny: it keeps only tool name, family, target basename, timing, status, and `agent.source`. Prompt text, assistant text, tool output, file contents, full commands, and arguments are dropped. `--show-args` is an explicit opt-in and includes only a truncated, redacted argument preview. ## Where things are `<skill>` means the folder containing this file. Run scripts from it by absolute path, e.g. `node <skill>/src/agent-transit/scripts/find-session.mjs --source codex`. The shared engine is at `<skill>/core/`. ## Steps 1. Find the newest local session path without reading its contents: `node <skill>/src/agent-transit/scripts/find-session.mjs --source claude-code|codex|cursor`. 2. Build one page to share: `node <skill>/core/build.mjs <session.jsonl> --format claude-code --share --title "Agent: one coding session, tool by tool"`. Without `--out` the file is named after the title and the first failed tool call, in `./transit-out/`, e.g. `transit-out/agent-shell-git-service-alert.html`. `--share` scrubs at the strict level, refuses `--no-scrub`, and opens the page paused on the first failed call with a one-line verdict above the map. Idle stretches with nothing running (e.g. model thinking time between tool calls) longer than 3 s are shortened to 3 s so the animation isn't dead air; the header says how many were shortened and the root span keeps the wall time as `transit.wall_ms`. Pass `--max-gap-ms N` to change the cap, or `--max-gap-ms 0` for true wall-clock timing. 3. Share the HTML file: give the user its path and the verdict line the build printed, ready to paste with the file in Slack (desktop and iOS open it as the interactive page). Use the printed verdict as is. For example: > shell · git failed after 12.0 s: denied · SERVICE ALERT · 18 calls > `agent-shell-git-service-alert.html` opens on the denied call. Only tool names and timing are in it. 4. Optional teaser (GIF + MP4) with the bundled renderer: `node <skill>/core/render.mjs <session.jsonl> --format claude-code --name agent`. 5. Check it with the bundled verifier: `node <skill>/core/verify.mjs <session.jsonl> --format claude-code --name agent`. Use `--format codex` or `--format cursor` for those sources. Cursor: most Cursor installs keep chats only in `state.vscdb`, not as transcripts. Export one composer to a metadata-only JSONL (tool name, status, file basename or command word, timestamps; never message text, params or results), opened read-only: `node <skill>/src/agent-transit/scripts/export-cursor.mjs --list` (sessions for the current workspace; `--workspace DIR` or `--all-workspaces`), then `node <skill>/src/agent-transit/scripts/export-cursor.mjs --composer <id or prefix> --out ./transit-out/agent/cursor.cursor.jsonl`, and build that with `--format cursor`. Cursor builds since about Sep 2025 stamp each message bubble with `createdAt`, so calls start at real times; Cursor stores no tool end time, so each call ends at the next message (an upper bound). Older bubbles and `agent-transcripts` files have no timestamps: order only, with uniform synthetic durations. Keep session files local and never upload them. Synthetic fixtures are provided in `samples/`; no real home-directory logs belong in this repository. ## Rules - Never expose or copy prompts, code, command lines, outputs, or arguments by default. - Only use the bundled build/render/verify scripts; never hand-write a substitute renderer. - Do not upload a session or render unless the user explicitly asks. - Review errors, denials, slow calls, and subagent branches in the map without revealing their payloads.
Files in this package (52)
- LICENSE 1 KB
- README.md 1 KB
- SKILL.md 4 KB
- package.json 1 KB
- core/adapters.mjs 1 KB
- core/build.mjs 11 KB
- core/cli.mjs 2 KB
- core/export.mjs 5 KB
- core/fsguard.mjs 3 KB
- core/gaps.mjs 2 KB
- core/render-frames.mjs 5 KB
- core/render.mjs 2 KB
- core/scrub.mjs 9 KB
- core/setup.mjs 15 KB
- core/still.mjs 1 KB
- core/tools.mjs 3 KB
- core/transit.template.html 84 KB
- core/verdict.mjs 6 KB
- core/verify.mjs 4 KB
- core/vocab.mjs 5 KB
- core/fonts/OFL-Arimo.txt 4 KB
- core/fonts/arimo-400.woff 12 KB
- core/fonts/arimo-700.woff 12 KB
- src/agent-transit/adapters/normalize-agent.mjs 15 KB
- src/agent-transit/samples/README.md 1 KB
- src/agent-transit/samples/claude-code-synthetic.jsonl 9 KB
- src/agent-transit/samples/codex-synthetic.jsonl 7 KB
- src/agent-transit/samples/cursor-bubbles-synthetic.jsonl 14 KB
- src/agent-transit/samples/cursor-synthetic.jsonl 4 KB
- src/agent-transit/samples/make-agent-samples.mjs 4 KB
- src/agent-transit/scripts/export-cursor.mjs 9 KB
- src/agent-transit/scripts/find-session.mjs 3 KB
- src/ci-transit/adapters/normalize-gh.mjs 7 KB
- src/request-transit/adapters/fetch-datadog-api.mjs 3 KB
- src/request-transit/adapters/fetch-posthog-api.mjs 4 KB
- src/request-transit/adapters/fetch-tempo.mjs 5 KB
- src/request-transit/adapters/fetch-xray.mjs 3 KB
- src/request-transit/adapters/normalize.mjs 30 KB
- src/request-transit/contracts/indexer.mjs 13 KB
- src/request-transit/contracts/match.mjs 5 KB
- src/request-transit/contracts/schema.mjs 3 KB
- src/request-transit/contracts/text.mjs 3 KB
- src/request-transit/contracts/extractors/class-validator.mjs 3 KB
- src/request-transit/contracts/extractors/express.mjs 2 KB
- src/request-transit/contracts/extractors/index.mjs 1 KB
- src/request-transit/contracts/extractors/joi.mjs 2 KB
- src/request-transit/contracts/extractors/nest.mjs 4 KB
- src/request-transit/contracts/extractors/openapi.mjs 3 KB
- src/request-transit/contracts/extractors/protobuf.mjs 4 KB
- src/request-transit/contracts/extractors/topic-producer.mjs 1 KB
- src/request-transit/contracts/extractors/ts-types.mjs 1 KB
- src/request-transit/contracts/extractors/zod.mjs 3 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · israelvicars/transit | 100 | MIT |
| israelvicars/transit | 100 | MIT |
Database snapshot: 13.11.2026 · package version 59fd695e7950 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100ci-transit
A transit map for your CI runs. Use when the user wants to visualize a GitHub Actions run as a subway map. Draws jobs as lines, steps as stations, and failed, cancelled or slow steps as service alerts. - 100ci-transit
A transit map for your CI runs. Use when the user wants to visualize a GitHub Actions run as a subway map. Draws jobs as lines, steps as stations, and failed, cancelled or slow steps as service alerts. - 100agent-session-resume
Use when continuing, resuming, locating, reading, inspecting, auditing, or reviewing a previous AI coding-agent session, handoff transcript, chat log, exported conversation, saved artifact set, or session summary, on any platform (Claude Code, Codex, Cursor, Antigravity,… - 90external-agent-onboarding
Onboards a non-Claude-Code coding agent (GitHub Copilot CLI / OpenAI Codex CLI / Cursor / Aider / Devin Desktop) to this repo at session start. Use when this repo will be operated on by an agent that does not natively read CLAUDE.md. Routes through AGENTS.md, then layers the… - 91send
Use when a user wants to start a new Claude Code, Codex, OpenCode, Cursor CLI, Pi, or Grok session from a coSlash session. - 100bb-install-and-connect
Use when bb is installed but the agent has no bb tools, or when wiring bb into Claude Code, Cursor, VS Code, Codex, Gemini, opencode or another agent host.