kamegoro/Commit Familiar
Claude draws (and incrementally evolves) a small original SVG character based on your repository's recent commit activity. Requires only an ANTHROPIC_API_KEY secret -- no separate image-generation service, no local setup for contributors.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| anthropic-api-key | Anthropic API key. Pass as a repo secret, never commit it. | yes | — |
| svg-path | Path (relative to repo root) where the character SVG is written. | no | familiar.svg |
| state-path | Path where the last-processed commit SHA is tracked. | no | .familiar-state.json |
| model | Anthropic model to use for the one-time initial design. | no | claude-sonnet-5 |
| readme-path | README to auto-embed the character into, between <!-- COMMIT-FAMILIAR:START --> / <!-- COMMIT-FAMILIAR:END --> marker comments. If the markers aren't found, embedding is skipped (add them once, anywhere you want the character to sit) -- the file itself is otherwise left untouched. | no | README.md |
| min-commits | Minimum commits since the last update before doing anything. Controls "is this activity worth an update", not run *frequency* -- frequency is entirely up to your own cron schedule. Commits below this threshold are not discarded; they carry over and count toward the next run. | no | 1 |
| display-width | Display width in the README, in CSS pixels (via an <img width="..."> tag). The SVG's own internal pixel grid is always 200x200 regardless of this setting -- this only controls how large it appears. | no | 140 |
Outputs
no outputs