Getting Started
1. Connect GitHub
Sign in with GitHub. Trace requests read-only access to your repositories. No write permissions are needed.
2. Add a repository
Go to Repositories and click "Connect repo." Select from your GitHub repos. Trace syncs the last 90 days of commits on connect.
3. Run your first analysis
Go to Project Analysis and select your repo. Click Generate to produce your first content piece. Trace analyzes your README, commit history, and project arc to find the story worth telling.
4. Find content in commits
Go to your repo dashboard. Click any commit to evaluate its story value. Commits that score high enough unlock a Create Content button.
5. Your content lives in the Content tab
Every generated piece, from both Project Analysis and individual commits, appears in the Content tab. Filter by pattern or format, expand any piece to read and copy it.
Project Analysis
Project Analysis looks at your repository as a whole, not commit by commit. It reads your README, project description, and commit history to understand what kind of project this is, who it's for, and what story it's been telling.
What it produces:
- Project type and target audience classification
- An editorial score (how much content potential this project has)
- One ready-to-post content piece based on the project arc
When to use it:
When you want to explain the whole project to an audience, not just what you shipped today. Use it for launch posts, introduction threads, and "what is this thing I've been building" content.
Input options:
- Full history (default)
- Last 30, 60, or 90 days (Pro: date range selector)
- By release or tag (Pro)
Format:
Free tier: Trace picks the best format for your project.
Pro tier: Choose from all five formats before generating.
Commit Analysis
Commit Analysis evaluates individual commits for their story value. Not every commit is worth a post. Commit Analysis tells you which ones are.
How it works:
- Click any commit in your repo dashboard to evaluate it
- Trace classifies the commit into one of the six story patterns
- A verdict score from 1 to 5 is assigned
- Commits scoring 3 or above unlock the Create Content button
- Click Create Content to generate a ready-to-post piece from that commit
Evaluation is free. Evaluating a commit does not count against your monthly generation limit. Only clicking Create Content counts as a generation.
Why some commits don't unlock content:
Version bumps, typo fixes, config changes, and dependency updates score low (1–2) and do not produce the Create Content button. This is intentional. Trace is an editor. It tells you when not to post.
The Six Patterns
Every piece of content Trace generates is classified into one of six story patterns. The pattern determines how the content is framed and what emotional angle it leads with.
StruggleThe honest documentation of what's hard. Debugging a gnarly bug at 2am, rethinking an architecture, shipping something that broke in production. Readers trust founders who show the difficulty, not just the win.
ShipThe moment something goes live. A feature, a fix, a redesign, a first deploy. Any shipped thing is postable. The Ship pattern leads with what changed and why it matters to the user.
DecisionThe reasoning behind a non-obvious technical or product choice. Why you chose Supabase over PlanetScale. Why you removed a feature. Why you rewrote the auth flow. The Decision pattern is for choices that had real trade-offs.
DeletionRemoving something is underrated content. Code deleted, features cut, approaches abandoned. The Deletion pattern is for commits where the diff is mostly negative lines. What you removed and why.
ComebackRecovery from a broken state, a failed experiment, or a wrong direction. The Comeback pattern is for commits that follow a period of struggle or inactivity. It documents resilience.
MilestoneA version, a launch, a number crossed. Real markers, not manufactured celebration. The Milestone pattern is for commits tagged to a release or a significant project threshold.
Content Formats
Trace generates content in five formats. Each has a distinct structure.
Short-form video hook
5 lines. Opens with a hook sentence, followed by three tight support lines, closes with a CTA or reframe. For YouTube Shorts, Reels, TikTok.
Long-form video hook
2–3 sentence setup that builds tension, followed by the payoff statement. For YouTube long-form introductions.
X Thread
Numbered tweets. Tweet 1 is the hook. Tweets 2–5 are standalone insights. Final tweet is a CTA or summary. Each tweet works alone.
LinkedIn post
Hook line (never "I am excited to share"). Three to four short paragraphs, one topic each. Closes with a question or CTA.
Marketing post
Problem (one sentence). Solution (one to two sentences). Proof or specificity (one sentence). CTA (one sentence). For product pages and announcements.
Content Tab
The Content tab is your unified content library. Every piece generated by Trace, from any repo, from any analysis, appears here.
Filtering:
Filter by pattern (Struggle, Ship, Decision, Deletion, Comeback, Milestone), by format, or show saved pieces only.
Expanding a piece:
Click any row to expand it inline. The full piece, why it works, and a Copy button appear below the row. Click again to collapse.
Save:
Mark a piece as saved to keep it at the top of your list. Saved pieces do not expire.
Dismiss:
Remove a piece you will not use. Dismissed pieces are hidden but not permanently deleted.
Free vs Pro
| Free | Pro | |
|---|---|---|
| Generations per month | 10 | Unlimited |
| Format selector | AI picks | You choose |
| Commit evaluations | Unlimited | Unlimited |
| Date range inputs | 30 days | 30 / 60 / 90 days |
| Release and tag inputs | No | Yes |
| Repositories | Unlimited | Unlimited |
Commit evaluations never count against your generation limit on any tier.