Skip to main content

GitTok

Doomscrolling Your Code

GitTok turns your git repos into a TikTok-style feed. Swipe through short posts about the code you work in every day: the function everything depends on, the commit that got reverted twice, the TODO that has been waiting for six years, the two files that always change together.

Some posts teach. Some are quizzes: spot the bug, guess who wrote it, guess when. Some are memes, comics, tier lists, group chats and horoscopes about your own code, with a cast of regulars arguing in the comments. Swipe up for the next post. Swipe sideways to go deeper, from the hook down to the real code and the real diff.

  • Every post is checked against git. Your coding agent (Claude Code or Codex) writes the posts, and GitTok verifies each cited commit, file and line before a post reaches your feed.
  • It learns what you like. What you read, like and skip shapes the posts that get made next. You can also just say it: "less memes, more of the sync engine."
  • It helps things stick. A quiz you got wrong comes back a day later, then after three days, then a week, until you have it.
  • It is private. Everything runs on your own machine. GitTok never writes to your repos and calls no model API of its own.

A GitTok feed on a phone, swiping up through five posts: a comic about garbage collection, a meme about a file deleted the day it was born, a group chat between two files, a spot-the-bug quiz, and a tier list of load-bearing files.

Quick start

macOS, uv, git and Claude Code or Codex:

uv tool install --python 3.13 gittok    # Claude Code: see "Better images" below
mkdir ~/gittok && cd ~/gittok
gittok init .
claude                                  # or: codex

Better images in Claude Code. Claude Code has no image tool, so without extras Claude draws the illustration and comic posts as simple flat SVG pictures. On Apple silicon, install with the images extra for real illustrations: uv tool install --python 3.13 'gittok[images]' (add --force if GitTok is already installed, then start a new session). On other Macs the extra adds nothing. It adds mflux (about 1 GB) and a 6 GB model that GitTok downloads by itself. Codex uses its own image tool by default. To use mflux in Codex instead, install with the extra and ask Codex: "Use local image generation." Or set it yourself in local/settings.yaml of your GitTok directory:

render:
  image_backend: local

In Claude Code, approve the gittok MCP server; in Codex, trust the project configuration and review /hooks. Then ask your agent: "Add the repo at ~/src/myapp to GitTok." When the first posts are made, open the feed address that your agent gives you on your phone (or ask "what is the feed address?"), tap "Pair with a code", tell your agent the code, and start scrolling. Both agents get the same skills, workers and MCP server.

Documentation

https://nvoxland.github.io/gittok/

Metadata

Release files for gittok 1.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gittok 1.3.1
File Size Uploaded Provenance Actions
gittok-1.3.1.tar.gz 29.6 MB With provenance Details for gittok-1.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gittok 1.3.1
File Interpreter ABI Platform Actions
gittok-1.3.1-py3-none-any.whl Python 3 none any Details for gittok-1.3.1-py3-none-any.whl

Total release size: 56.9 MB

Release files / gittok-1.3.1.tar.gz

Download URL gittok-1.3.1.tar.gz
Size 29.6 MB
Tags Source
SHA-256 checksum
How to use checksums
f2d8c805be48994e6dbd77e0dbd14b16cfd0f4514b9c2f9c4830618c794d3865
BLAKE2b-256 checksum
How to use checksums
8f9aace0618cfbbd697c484f60173d296f83cde1dc5db00bd37cdff4eb8e4b1d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / gittok-1.3.1-py3-none-any.whl

Download URL gittok-1.3.1-py3-none-any.whl
Size 27.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
630a23c416c26eeeb8c7c5bee13b49ed4250a8a7cace83486f08a392300cc8d1
BLAKE2b-256 checksum
How to use checksums
71965d7de5bcd89a239c1feb90251a625bca477e6b27fc0ba4860774951cf8ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for gittok 1.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for gittok-1.3.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page