Pick a path

BurrowTime works as a human-operated timer and as a safe clock for coding agents. If you are here because you want an AI agent to track its work, start with the agent guide. The normal CLI needs no agent setup.

Export to Clockify

Map projects, round each entry, and review a batch before uploading.

Optional plugin →

Install BurrowTime

Get the standalone command for Linux, macOS, or Windows.

Installation →

Track coding agents

Set up Codex, Claude Code, Cursor, Gemini CLI, or OpenCode.

Agent guide →

Connect over MCP

Use BurrowTime with any client that can launch a local MCP server.

MCP setup →

Move from Watson

Copy your history safely and preserve Watson's file format.

Migration guide →

The short version

go install github.com/fabean/BurrowTime/cmd/burrowtime@latest

burrowtime start "client portal" +review
burrowtime status
burrowtime stop
burrowtime report --week

Local means local. BurrowTime does not require an account, cloud database, or tracking service. It writes ordinary files in its data directory.

How the pieces fit

The interactive dashboard and direct CLI use the same storage and reporting code. Agent sessions add ownership, leases, safe retries, and pause or resume behavior around standard timers. When a session ends, its work is still a normal Watson-compatible frame.