Claude Presence

claude-presence

 

My first open-source project. It puts a silly coding vibe, your total commits, and your Claude Code token usage on your Discord profile.


Everything runs locally. Nothing gets sent anywhere except your own Discord app (same way games announce "Playing X").

Setup

You need Python 3.9+ and the Discord desktop app open.

Tested on Windows. Should work on Mac/Linux too since the Python is cross-platform and `pypresence` speaks Discord IPC on every OS, but I haven't tried it there. If it breaks, open an issue.

1. Clone and install

git clone https://github.com/TheRealSwisa/Claude-Presence
cd Claude-Presence
pip install -r requirements.txt
cp .env.example .env

2. Make a Discord app

1. Go to https://discord.com/developers/applications and click New Application. Name it whatever you want shown on your profile (no spaces, something like ClaudeCode or your initials).
2. Copy the Application ID into .env as DISCORD_CLIENT_ID.
3. Click Rich Presence → Art Assets → Add Image(s). Upload any square PNG, name its key logo. That shows up as the big icon next to your profile text.
4. Set an App Icon on the General Information tab if you want one.

This repo has no images. Use your own.

3. Run it

python vibe.py

Give it 15 seconds, then check your Discord profile. You should see a "Playing " block with the vibe, your commits, your tokens, and an elapsed timer.

Ctrl-C to stop.

Running it

Start / stop

run.bat      start the daemon
stop.bat     kill the daemon

On macOS / Linux just do `python vibe.py` to start, Ctrl-C to stop.

Run at login (Windows)

install-autostart.bat

That drops a shortcut into your Startup folder pointing at `pythonw.exe`, so there's no console wind