Connect

Three steps, about three minutes, and every AI partner starts reporting.

Have the URL and token ready

The collectors need two things: this server's address, and the value of the server's HEYBOSS_TOKEN environment variable (dev-token in development).

export HEYBOSS_URL=http://localhost:3210
export HEYBOSS_TOKEN=<token>

Install a collector on each machine

Put these environment variables in the person's shell profile, then add one line of config for their tool.

export HEYBOSS_EMPLOYEE=lin.xiao      # A unique ID for the person, e.g. lin.xiao
export HEYBOSS_NAME='Lin Xiao'          # Name shown on the dashboard (optional)
export HEYBOSS_TEAM=backend            # Their team (optional)

Add a SessionEnd hook to ~/.claude/settings.json. When a session ends the script reads the local transcript, reduces it to counts and a one-line summary, and reports it.

# Download the script
mkdir -p ~/.heyboss && curl -fsSL http://localhost:3210/collectors/claude-code-hook.mjs -o ~/.heyboss/claude-code-hook.mjs

# ~/.claude/settings.json
{
  "hooks": {
    "SessionEnd": [{
      "hooks": [{ "type": "command", "command": "node ~/.heyboss/claude-code-hook.mjs" }]
    }]
  }
}

Verify

Run once with HEYBOSS_DRY_RUN=1: the script only prints what it would report. When it looks right, remove it, finish an AI session, and it shows up under Activity within 30 seconds.

Everything that gets reported

Tool, project folder name, session time and length
Number of turns, token usage
Files changed, lines added and removed, commits
A one-line summary (the session title, or the first 200 characters of the first prompt)