Docs / Getting started

From install to first report in five minutes.

TeamLaboration is one process. It installs to a per-user directory, starts at login, and serves a dashboard at http://localhost:7842. The steps below take you end to end.

Before you start

· Windows 10/11 (x64) or macOS 13+ on Apple Silicon. No admin rights needed on either.
· An Anthropic API key from console.anthropic.com. You can defer this — see step 5 for the no-key workflow.

Step 01

Install

Grab the installer for your OS. No admin elevation prompt. The app registers itself for at-login start automatically — Task Scheduler on Windows, LaunchAgent on macOS.

↓ Download for Windows ↓ Download for macOS (Apple Silicon)

Windows

· Installs to %LOCALAPPDATA%\TeamLaboration
· Data lives in %APPDATA%\TeamLaboration
· Tray icon in the system tray

macOS

· Drag from the DMG to /Applications
· Data lives in ~/Library/Application Support/TeamLaboration
· Runs headless under launchd

Step 02

Open the dashboard

The daemon binds to localhost only - never the open network. Click on system tray icon it will open page:

http://localhost:7842

Step 03

Paste your Anthropic API key

Open Settings in the dashboard and paste your key. It's written to the OS credential store — Windows Credential Manager or macOS Keychain — via the keyring library. The key never lands on disk in plaintext, and the only outbound network call TeamLaboration makes is to api.anthropic.com using this key.

Don't want to give the daemon a key? Set ai_enabled = false in Settings — see step 5.

Step 04

Wait for the first poll

Every five minutes (configurable) the collector walks sessions, and queues any new or changed sessions for summarization. The default schedule then summarizes pending sessions once a day at the hour you pick in Settings.

If you want results now, open the Week view and click Generate Report. This runs both summarization and the weekly rollup immediately for the selected week.

Step 05 · optional

Register the MCP server

TeamLaboration exposes an MCP server at /mcp/ on the same local port. Register it once with Claude Code:

claude mcp add --transport http teamlaboration http://localhost:7842/mcp/

Keep the trailing slash on /mcp/ — without it Starlette returns a 307 redirect that the MCP HTTP client doesn't follow, and the handshake fails. Verify with claude mcp list.

After registration you can ask Claude Code things like "summarize my week," "flag the auth session as a highlight," or "what did I work on in project X?" — and Claude will call the right tools. More on MCP.

mcp__teamlaboration_summarize_pending and mcp__teamlaboration_summarize_pending commands allow you to create weekly report without Anthropic API key.

Troubleshooting

No sessions show up after a poll

Confirm Claude Code has actually written files to ~/.claude/projects/. The collector only sees the JSONL session files it produces — a fresh install with no session history will be empty until you use Claude Code.

Summarization stays "pending"

Either the API key isn't saved, ai_enabled is false, or the daily summarize hour hasn't fired yet. Click Generate Report in the Week view to force it.

Dashboard doesn't load

Check logs/agent.log in the data directory. Common causes: port 7842/7843/7844 all bound by other apps, or the daemon hasn't autostarted. Launch the app manually to register the autostart entry.

Set TEAMLABORATION_DEBUG=1 for verbose logs

Restart the daemon after setting it. Logs will include the full collect/summarize pipeline traces.

← All docs Next: Configuration →