clawd-presence

Clawd Presence (Claude Code -> Discord Rich Presence)

Windows-only helper that shows Claude Code activity in Discord Rich Presence. It runs a small background daemon that applies updates and keeps Discord in sync while you work.

Requirements

• Windows 10/11
• Discord Desktop client running
• Claude Code with hooks enabled
• Git (optional, for repo/branch display)

Quick start

# from repo root
.\install.ps1

The installer builds the helper (if Go is available), writes config (if you enter a Client ID), and installs/updates the plugin. If a manual install exists, it removes the old clawd-presence folder first.

How it works (short)

Claude Code hooks invoke dist/windows/claude-hooks/presence.ps1. The script writes the desired presence state and a background daemon applies it to Discord. On session end, the daemon clears or idles your presence based on config.

Usage

• Presence updates automatically on session start, prompts, tool runs, failures, and session end.
• To change what appears, edit the config file (see below).
• To refresh or update the plugin, re-run install.ps1.

Configuration

Global config path:

• %APPDATA%\ClawdPresence\config.json

Example:

{
  "discord": {
    "clientId": "YOUR_CLIENT_ID",
    "largeImageKey": "clawd",
    "largeImageText": "Claude Code",
    "smallImageKey": "terminal",
    "smallImageText": "Windows"
  },
  "privacy": {
    "showRepo": true,
    "showBranch": true,
    "showToolName": true
  },
  "behavior": {
    "onSessionEnd": "clear",
    "updateDebounceMs": 500
  }
}

Optional (no file): set CLAWD_PRESENCE_CLIENT_ID or DISCORD_CLIENT_ID in your environment. If no Client ID is configured, the helper uses a shared default application ID.

Project override:

• <repo>\.claude\presence.json (same schema as global config)

Update / reinstall

.\install.ps1

If you use a manual install, also pass -PluginDir to your plugins folder. The script removes any existing clawd-presence directory before reinstalling.

Manual install (no marketplace)

Use this when the Claude CLI is unavailable or marketplace install fails.

1. Build (optional but recommended):

go build -o dist\windows\clawd-presence.exe .\cmd\clawd-presence

2. Install the plugin folder:

# Example: plugins directory is %USERPROFILE%\.claude\plugins
.\install.ps1 -PluginDir "$env:USERPROFILE\.claude\plugins" -Mode Junction

3. Restart Claude Code.

Manual hook setup (no plugin)

Add these commands to your .claude/settings.json hooks if you want to wire hooks by hand:

{
  "hooks": {
    "SessionStart": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "powershell -NoProfile -ExecutionPolicy Bypass -File C:/path/to/dist/windows/claude-hooks/presence.ps1",
        "timeout": 5
      }]
    }],
    "UserPromptSubmit": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "powershell -NoProfile -ExecutionPolicy Bypass -File C:/path/to/dist/windows/claude-hooks/presence.ps1",
        "timeout": 5
      }]
    }],
    "PreToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "powershell -NoProfile -ExecutionPolicy Bypass -File C:/path/to/dist/windows/claude-hooks/presence.ps1",
        "timeout": 5
      }]
    }],
    "PostToolUseFailure": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "powershell -NoProfile -ExecutionPolicy Bypass -File C:/path/to/dist/windows/claude-hooks/presence.ps1",
        "timeout": 5
      }]
    }],
    "Stop": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "powershell -NoProfile -ExecutionPolicy Bypass -File C:/path/to/dist/windows/claude-hooks/presence.ps1",
        "timeout": 5
      }]
    }],
    "SessionEnd": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "powershell -NoProfile -ExecutionPolicy Bypass -File C:/path/to/dist/windows/claude-hooks/presence.ps1",
        "timeout": 5
      }]
    }]
  }
}

Manual fixes / troubleshooting

• Presence not showing: ensure Discord desktop app is running and you provided a valid Client ID.
• Hooks not firing: confirm the hook command path points to the correct presence.ps1 file.
• Stale presence: run dist/windows/clawd-presence.exe clear or restart Claude Code.
• Plugin stuck: re-run install.ps1 to reinstall and refresh the plugin files.

Diagnostics

.\dist\windows\clawd-presence.exe diagnose

Files & locations

• Global config: %APPDATA%\ClawdPresence\config.json
• Project override: <repo>\.claude\presence.json
• State file: %LOCALAPPDATA%\ClawdPresence\state.json
• Logs: %LOCALAPPDATA%\ClawdPresence\logs\YYYY-MM-DD.log