BurrowTime

Track your own work and coding-agent tasks in local files, with a terminal dashboard and Watson-compatible history. An optional Clockify connector adds reviewed exports and rounding while keeping local times exact.

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.

Export time to Clockify

An optional Clockify connector exports completed entries with project mapping, client names, and an editable review before upload. Choose descriptions, destinations, durations, and billable settings, with optional rounding applied only to the exported time. Local records retain their exact durations, and local receipts let later runs skip successful uploads.

Exports run when requested. This first version does not import Clockify changes or update previously uploaded entries. Clockify support is currently on main, ahead of the next tagged release; follow the Clockify setup guide to install BurrowTime and the separate connector.

Install it

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

BurrowTime is MIT licensed. Visit the BurrowTime website, get release binaries or read the agent setup instructions and source on GitHub.