Setup Guide

Get your Coding Buddy up and running in three simple steps. Connect your Claude Code sessions to your phone in under a minute.

1 Get your API key

Create a free account and find your unique API key on the dashboard. This key connects your Claude Code sessions to your phone.

Create account Go to dashboard

2 Install Claude Code hooks

The hooks send status events to your buddy whenever Claude starts working, finishes, or waits for input.

Recommended

A One-liner Install

Run this command in your terminal to install everything automatically:

curl -sL https://coding-buddy.com/install/YOUR_API_KEY_HERE | python3

B Manual Setup

Create the hook script yourself for full control over the installation.

View instructions
Manual hook setup instructions

1. Create the hooks directory:

mkdir -p ~/.claude/hooks/coding-buddy

2. Save this as ~/.claude/hooks/coding-buddy/send_status.py:

#!/usr/bin/env python3
"""Send Claude Code hook events to Coding Buddy bridge server."""
import json, sys, urllib.request

API_KEY = "YOUR_API_KEY_HERE"
URL = "https://coding-buddy.com/event"

def main():
    payload = json.loads(sys.stdin.read())
    event = payload.get("hook_event_name", "")
    tool = payload.get("tool_name", "")
    session = payload.get("session_id", "")

    data = json.dumps({
        "event": event,
        "tool_name": tool,
        "session_id": session
    }).encode()

    req = urllib.request.Request(
        URL,
        data=data,
        headers={
            "Content-Type": "application/json",
            "X-API-Key": API_KEY
        }
    )
    try:
        urllib.request.urlopen(req, timeout=5)
    except Exception:
        pass

if __name__ == "__main__":
    main()

3. Make it executable:

chmod +x ~/.claude/hooks/coding-buddy/send_status.py

4. Add the hooks to ~/.claude/settings.json:

{
  "hooks": {
    "SessionStart": [
      { "matcher": "*", "hooks": [{ "type": "command", "command": "python3 ~/.claude/hooks/coding-buddy/send_status.py" }] }
    ],
    "SessionEnd": [
      { "matcher": "*", "hooks": [{ "type": "command", "command": "python3 ~/.claude/hooks/coding-buddy/send_status.py" }] }
    ],
    "UserPromptSubmit": [
      { "matcher": "*", "hooks": [{ "type": "command", "command": "python3 ~/.claude/hooks/coding-buddy/send_status.py" }] }
    ],
    "PreToolUse": [
      { "matcher": "*", "hooks": [{ "type": "command", "command": "python3 ~/.claude/hooks/coding-buddy/send_status.py" }] }
    ],
    "PostToolUse": [
      { "matcher": "*", "hooks": [{ "type": "command", "command": "python3 ~/.claude/hooks/coding-buddy/send_status.py" }] }
    ],
    "Stop": [
      { "matcher": "*", "hooks": [{ "type": "command", "command": "python3 ~/.claude/hooks/coding-buddy/send_status.py" }] }
    ]
  }
}

Note: The manual setup covers status events only. For voice input from the Android app, use the one-liner install (option A) which also sets up the voice receiver.

3 Connect the Android app

Download the app and enter your API key to see your buddy come alive.

  1. Download the Coding Buddy app from the Google Play Store (or sideload the APK)
  2. Open the app and tap Settings
  3. Enter your API key: YOUR_API_KEY_HERE
  4. Tap Connect — your buddy should come alive!

✓ You're all set!

Start a Claude Code session and your buddy will come alive. If something isn't working, ask Claude to check your hooks setup first. Still stuck? Submit a bug report from your dashboard.