Metadata-Version: 2.4
Name: jitters-cli
Version: 0.1.0
Summary: Jitters the VibeCoder, an anxious monkey, in the state of your week of commits: groggy after 2 am, fit after a week of daytime ones. CLI and MCP server; reads only your commit hours, sends nothing.
Author: Vibeoverflow
License: MIT
Project-URL: Homepage, https://vibeoverflow.lol/week?src=pypi
Project-URL: Shop, https://vibeoverflow.lol/shop.html?src=pypi
Keywords: mcp,mcp-server,git,commits,vibe-coding,claude-code,cli,tamagotchi,monkey
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 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](https://vibeoverflow.lol/shop/333am.webp)

```
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](https://vibeoverflow.lol/week?src=pypi).

## 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?"

```json
{ "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](https://vibeoverflow.lol/shop.html?src=pypi).

MIT. Made by the Vibeoverflow team, [vibeoverflow.lol](https://vibeoverflow.lol/?src=pypi).

<!-- mcp-name: lol.vibeoverflow/jitters -->
