GitHub Stories
Independent project · not affiliated with GitHub

GitHub Stories

Stories for GitHub. Yes, those Stories.

Photos, videos, selfies, concerts, cats, food, memes, shitposts. They expire after 24 hours. They appear as a ring on avatars you already know, and in your terminal.

The demo runs in your browser with fictional sample content. No login.

The Story viewer open over a pull request: a concert photo with a reply box and emoji reactions.
Real extension capture. Fictional account, sample photo.

01 / Rings

The ring you already recognise, on the avatars you already know.

The extension puts a pink-to-purple ring around avatars on pull requests, issues and profiles when that person has a Story you can see. Click it and the Story opens over the page. Close it and your code review is exactly where you left it.

It never writes to github.com and never touches who you follow there. Follows on Stories are separate.

02 / Post

Drop in a photo. Pick who sees it. It cleans up after itself.

01

Compose

Drag in a photo or video, crop it, rotate it, add a caption and alt text.

02

Choose

Five audiences, picked before you post. There is no default that quietly means everyone.

03

Forget

Every item expires 24 hours after it was published. Nothing to clean up later.

gh stories showing a Story in a terminal: progress bars, the author, a cat photo rendered inline and keyboard hints.

Real capture of the CLI in a terminal that supports inline images.

03 / Terminal

A picture, in your terminal. Really.

gh stories draws the actual image inline using the Kitty graphics protocol, or iTerm2's inline images. Everywhere else it falls back honestly: it opens the image in your viewer and tells you so.

See the exact support matrix →

04 / Privacy

Privacy, plainly.

Every Story is published to exactly one audience, chosen before you post.

  • People I follow

    Only people you follow on Stories can see this.

  • My followers

    Only people who follow you on Stories can see this.

  • Mutuals

    Only people you follow who also follow you back can see this.

  • Custom list

    Only the people on the list you choose can see this.

  • Public — anyone, no sign-in required

    Anyone with the link can see this, even without signing in.

24 hours, per item

Each item expires 24 hours after it was published, not after your last post. Nothing can be pinned past that.

No long-lived links

Private media is streamed through an authorization gateway, so a block or a deletion takes effect immediately.

What the extension sends

On github.com it looks up which visible accounts have a Story, using the avatar ids and logins it sees. Nothing is written to GitHub.

None of this un-sends a photo someone already saw. Deleting a Story stops future access; it cannot reach back onto another person's screen.Full privacy and retention page →

05 / Install

Two clients, one account.

Chrome & Edge

store: coming soon

Not in the Chrome Web Store yet. Manual install from the release archive takes about a minute.

Firefox

add-on: coming soon

There is no signed Firefox add-on yet. Load the release archive as a temporary add-on.

Terminal

gh extension
gh stories
$ gh extension install alliecatowo/gh-stories
$ gh stories setup
$ gh stories login
$ gh stories

Step-by-step instructions for each browser are on the install page. Source and releases are on GitHub.