# docs

git-to-x docs

git-to-x turns your GitHub commit history into a daily build-in-public presence on X — automatically. Connect once; posting runs every morning while you code.

How it works

1. 1

   Connect GitHub + X

   Install the git-to-x GitHub App on your repo (read-only) and authorise your X account via OAuth. No API keys touch your machine.

2. 2

   Daily commit card rendered

   Each morning the worker aggregates the previous day's commits, renders a designed stat card (commits, diff, streak, repo name), and uploads it.

3. 3

   AI caption drafted

   An ICP-aware caption is drafted from your commits and your landing-page profile. You get a Telegram message to approve or edit it — or just ignore it and it auto-posts.

4. 4

   Posts every morning

   The card + caption go to X at your chosen time (default 08:30 local). Zero-commit days get no post — no filler.

5. 5

   Build page published

   Your public build page at /w/[slug] shows your changelog, accepts email signups, and links back to your product.

Reference