BurrowTime

Let your coding agents clock requested tasks alongside your own work. BurrowTime combines agent sessions, bundled skills, and MCP tools with local reports, a terminal dashboard, and Watson-compatible history.

BurrowTime is a local time tracker for you and your coding agents. Ask an agent to track a task under a project and ticket, and it can manage its own timer while you keep using the same terminal dashboard, logs, and reports.

Let your agents clock their work

Version 0.2.0 adds dedicated agent sessions and bundled skills for Codex, Claude Code, Cursor, Gemini, and OpenCode. Install the skill for your client, then request tracking in the task prompt:

burrowtime skill install codex
burrowtime skill doctor codex

Track this work in BurrowTime under "client portal" +PORTAL-42.

The skill starts tracking only when asked and requires a project and task or ticket. It tells the agent to retain its exact session ID, pause while waiting for required input, resume when work continues, and stop that session when finished. Agent timers can run alongside your own work without replacing unrelated active timers.

Handle retries and interrupted work

Agent sessions support retry keys that prevent repeated start requests from creating duplicate sessions. Renewable leases put a deadline on unattended work; recovery closes an expired session at its lease deadline. You can inspect sessions, recover interrupted timers, and report time by session and agent client with the burrowtime agent commands.

You can also stop an agent timer from the normal CLI or dashboard. A later stop request from the agent recognizes that the session has already ended. Completed work becomes ordinary Watson-compatible time records in the same local history. Concurrent sessions contribute their full durations, so overlapping work is counted separately.

Skills, CLI, and MCP

The bundled installer supports all five coding clients, and skill doctor checks the installed skill and binary for compatibility. Agents with MCP support can connect to burrowtime mcp for session control, heartbeat, recovery, status, and reporting tools.

Direct agent commands can read project, task, repository, and lease defaults from .burrowtime.toml, with optional ticket detection from the Git branch. Installing a skill or adding repository defaults does not turn tracking on automatically.

Still a time tracker for people

BurrowTime is written in Go and keeps Watson-compatible commands and data. Running burrowtime opens a Bubble Tea dashboard with active timers, recent work, interactive logs, reports, date ranges, and filters. Direct commands support scripts, JSON, and CSV.

Migration copies existing Watson history with confirmation and backups, and completed timers retain the familiar file format. Your time data stays in ordinary local files, with no account or hosted service required.

Install it

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

BurrowTime is MIT licensed. Get release binaries or read the agent setup instructions and source on GitHub.