Show your work. Showtail keeps a clear record of how you built a project with AI: the prompts you sent and the files you changed along the way. It captures this automatically as you work, so the trail builds itself.
Showtail writes that record to a plain .showtail/ folder inside your project. There are no accounts, no cloud service, and no telemetry. It is just local files that you and your educator can open, review, and commit with the rest of your work.
# Install (below), then just work — your prompts and edits are captured automatically.
showtail report # when you're done: generate the report for your educatorThere is no setup step. Installing turns tracking on and connects your AI tools for
you — including ones you install later — so a student never has to run a command to get
started. Just install, work, and generate a report at the end. Prefer to wire up one
project by hand, or turn tracking off? See showtail track
and showtail setup --off.
Full documentation: tingsters.github.io/Showtail
- Getting started — install and capture your first trail
- Integrations — Claude Code, Codex, Copilot, ChatGPT, Gemini
- How it works — the event model and data layout
- CLI reference — every command and flag
- Privacy & redaction — what's captured, what's scrubbed
- For educators — running this in a class
- A show your work tool for coursework and projects — your prompts and edits, captured automatically as you work with AI.
- A local, file-based trail that is easy to commit to git and easy for a human to review.
- Team-aware: each student gets their own folder under one shared
.showtail/, so trails merge through git without conflicts.
It is not an AI detector, not surveillance, not a cloud service, and not a grading tool — it produces a report so people can review the work, not judge it. Read more →
Claude Code ✅ · OpenAI Codex ✅ · GitHub Copilot 🚧 · ChatGPT / Gemini ✅ (import)
Tools with hooks capture live as you work; hosted chat apps import from a shared conversation. Full capability matrix →
One-line install of a standalone binary — no runtime required:
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/Tingsters/Showtail/main/install.sh | bashWindows PowerShell:
irm https://raw.githubusercontent.com/Tingsters/Showtail/main/install.ps1 | iexPrefer Bun or building from source? See Installation.
Showtail is built with TypeScript on Bun. See Contributing & development for build and test commands and how to work on the docs site.