Skip to main content

jitters-cli

Jitters the VibeCoder, an anxious monkey who codes, in the state of your week of commits. Groggy after your 2 am commits, fit after a week of daytime ones, on the sofa after a week of none.

Jitters at 3:33 am, asleep on the keys

uvx jitters-cli

(or pipx run jitters-cli; with Node: npx -y https://vibeoverflow.lol/dl/jitters-cli.tgz)

        .-"""-.   3am
   .-. / .---. \ .-.
  ( (_|  @   -  |_) )
   '-.|    v    |.-'
      \   ~~~   /
       '-.___.-'
  c[_] c[_] c[_] c[_] c[_]

Jitters, your week: groggy
You commit after midnight. He is groggy and on his fifth coffee.

It prints one link to see him drawn in that mood, with a picture to save: vibeoverflow.lol/week.

What it reads

Only the dates and hours of your own commits (your git config user.email) of the last 7 days in the folder it runs in. No network call, no telemetry, no dependency. The link carries the mood word, nothing else. --all counts every author.

The rules, first that holds

  1. seven days with nothing committed: sofa
  2. a third or more of your commits between midnight and 5 am: groggy
  3. ten or more a day: wired
  4. five days or more of daytime commits, none after midnight: fit
  5. one or more a day: steady
  6. less than one a day: sleepy

For your coding agent (MCP)

One tool, jitters_week: "how wrecked is my monkey?"

{ "mcpServers": { "jitters": { "command": "uvx", "args": ["jitters-cli", "--mcp"] } } }

Claude Code: claude mcp add jitters -- uvx jitters-cli --mcp

Options

--json prints the answer as JSON; --all every author; --mcp runs the stdio server.

Him, on your desk

Jitters at your own commit hour on a mug, and his night as stickers: the shop.

MIT. Made by the Vibeoverflow team, vibeoverflow.lol.

Metadata

Release files for jitters-cli 0.1.0

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

Source distribution (sdist)

Source distribution for jitters-cli 0.1.0
File Size Uploaded Provenance
jitters_cli-0.1.0.tar.gz 8.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for jitters-cli 0.1.0
File Interpreter ABI Platform
jitters_cli-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 16.6 kB

Release files / jitters_cli-0.1.0.tar.gz

Download URL jitters_cli-0.1.0.tar.gz
Size 8.1 kB
Tags Source
SHA-256 checksum
How to use checksums
be34523272007b22e02ea4f6698149bb9ea9c2e0b3233a94809565cc5eb57b89
BLAKE2b-256 checksum
How to use checksums
c8ba01742690d57082c756f96df7d011e8234b390cb54a91ddcac5f5b74affa9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / jitters_cli-0.1.0-py3-none-any.whl

Download URL jitters_cli-0.1.0-py3-none-any.whl
Size 8.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1578051038ac4f13c15866bd0e1ed8110c0b669cbe24d6cf26d93aa4914db3ce
BLAKE2b-256 checksum
How to use checksums
686f56215b2e60e73162f2c9c02e76dd2f051c2a6800e17b646036f041d22f41
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for jitters-cli 0.1.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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