Skip to main content

The Python library that makes you actually work

Project description

get2work

The Python library that makes you actually work.

PyPI version Python 3.9+

get2work is a CLI tool that gamifies your coding productivity. It celebrates your commits, roasts your git history, shames you when you're slacking, and makes you actually ship things.

Features

  • Commit celebrations — animations and sounds every time you commit
  • Level system — 8 levels from "Hello World Survivor" to "Linus Would Be Proud"
  • Streak tracking — daily commit streaks
  • Shame notifications — get roasted if you haven't committed today
  • AI roasts — your commit history analyzed and destroyed by AI
  • Vibe check — AI mental health diagnosis based on your commits
  • Peer pressure — see what other devs are shipping and feel bad
  • Pomodoro timer — focus sessions that count toward your level
  • Accountability receipt — daily summary of what you actually did
  • Code funeral — deleting 100+ lines triggers a funeral
  • Git blame but personal — AI roasts each commit individually

Installation

pip install get2work

Quick Start

# Install the git hook in your repo (do this once per project)
get2work install

# Check your level and stats
get2work status

# Now just commit normally and watch the magic happen
git commit -m "feat: add something cool"

Commands

Command Description
get2work install Install git hook in current repo
get2work status Your level, streak, and stats
get2work roast Get your commits roasted by AI
get2work vibe AI mental health diagnosis
get2work blame Git blame but make it personal
get2work peer <username> Stalk a dev on GitHub
get2work randompeer Random dev from the internet
get2work pomodoro Start a pomodoro timer
get2work shame Check if you deserve to be shamed
get2work receipt Your accountability receipt
get2work start Start background watcher

AI Features (Optional)

The roast, vibe, and blame commands use AI for better results. Without an API key they fall back to hardcoded funny responses.

To enable AI roasts set your OpenAI API key:

export OPENAI_API_KEY="sk-..."

Custom Sounds

Replace default sounds with your own by setting environment variables:

export GET2WORK_SOUND_CELEBRATE="/path/to/your/sound.mp3"
export GET2WORK_SOUND_FUNERAL="/path/to/funeral.mp3"
export GET2WORK_SOUND_SHAME="/path/to/shame.mp3"
export GET2WORK_SOUND_LEVELUP="/path/to/levelup.mp3"

Level System

Level Name Commits needed
1 Hello World Survivor 0
2 Tutorial Finisher 10
3 Functional but Confused 30
4 It Works Don't Touch It 60
5 Commits with Confidence (wrongly) 100
6 git push --force and it worked 200
7 The Last Line of Defense 400
8 Linus Would Be Proud 700

Tutorial

Open In Colab

Docker

docker build -t get2work .
docker run get2work

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

get2work-0.2.0.tar.gz (242.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

get2work-0.2.0-py3-none-any.whl (15.7 kB view details)

Uploaded Python 3

File details

Details for the file get2work-0.2.0.tar.gz.

File metadata

  • Download URL: get2work-0.2.0.tar.gz
  • Upload date:
  • Size: 242.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for get2work-0.2.0.tar.gz
Algorithm Hash digest
SHA256 78e8a95a8f862ec4b14a77bd8ae2ebf56743feea74a6148dfefc3be2c389a01c
MD5 df435e3d345783d9958f0a0fe5b1da85
BLAKE2b-256 4bbfd8c7c6ce5fdaaf4b3ddb8b22bd78c33dc5355acc68b2945d6cb376f15296

See more details on using hashes here.

File details

Details for the file get2work-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: get2work-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 15.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for get2work-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5ed253cdc0247191d372a1b6369e275404ddfe25eb839c8debf3f8fef7805a87
MD5 f4a0544742bc788cc192d18b8471236b
BLAKE2b-256 683c43b6f5d453f097d87810901e23acbf44abc1cda12d1411fa3e2bbcc32f80

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page