Skip to content

Tingsters/Showtail

Repository files navigation

Showtail logo: a Cavalier King Charles Spaniel beside the word Showtail, with a dotted trail of prompt, edit, code, and document icons

Showtail

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.

showtail setup     # one-time: connect your AI tools and turn on automatic tracking
# ...now just work — your prompts and edits are captured automatically...
showtail report    # generate the report for your educator

Once a tool is connected, Showtail sets up each project for you the first time you work in it — there is no separate init step to remember. Prefer to wire up one project by hand? Use showtail track then showtail connect <tool> instead.

📚 Documentation

Full documentation: tingsters.github.io/Showtail

What Showtail is

  • 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 →

Integrations at a glance

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 →

Installation

One-line install of a standalone binary — no runtime required:

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Tingsters/Showtail/main/install.sh | bash

Windows PowerShell:

irm https://raw.githubusercontent.com/Tingsters/Showtail/main/install.ps1 | iex

Prefer Bun or building from source? See Installation.

Contributing

Showtail is built with TypeScript on Bun. See Contributing & development for build and test commands and how to work on the docs site.

License

Apache-2.0

About

Showtail helps students show their work by capturing prompts, edits, decisions, artifacts, and reflections throughout a project, creating a verifiable trail educators can review.

Resources

License

Contributing

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages