Get it for macOS

See what your agents worked on and when, as a calendar of work blocks or a weekly time sheet. Each thread gets a block for the time its agent turns ran, colored by project, in a day, 3-day, or week view. Switch to Projects to merge a project's parallel threads into one entry, or open the time sheet to copy hours per thread and day as CSV. Agents can answer "what did my agents work on last week?" with the bb agent-calendar command and its bundled skill. Turn history stays in a local database on the bb server and uses no external service.


Overview

View source

Check your agents like your own calendar

Open Agent Calendar from the app sidebar to see a Day, 3 days, or Week at a time. Each thread is its own block, colored by its project and labeled with its title, time span, and project. Click a block to open the thread, or click a day's header to focus on that day. Summary cards show the thread count, hours on the calendar, raw agent-turn time, and peak number of agents running in parallel.

Switch to Projects to merge a project's parallel threads into one entry, such as "monorepo, 9:00–11:45, 17 threads". Click the entry to list its threads and open one.

Time sheet

The Time sheet lists every thread under its project, with decimal hours for each day of the week and a total. Copy as CSV puts the project, thread title, thread ID, daily hours, and total on your clipboard.

How blocks are built

A thread appears on the calendar only while an agent turn is running. Turns of the same thread separated by at most the merge gap become one block. The gap is 30 minutes by default, with 15m, 1h, and 2h available. Each block is rounded out to the surrounding quarter hours, so a two-minute turn takes a 15-minute slot.

Hours count each thread, so five agents working for one hour count as five hours. "Agent turns" is the time turns were running, before merging and rounding. The eight projects with the most agent time over the last 30 days get their own colors; other projects share a neutral color.

Command line

Agents and scripts can read the same data with bb agent-calendar, and the bundled skill teaches agents to use it for questions such as "what did my agents work on last week?".

bb agent-calendar                      # this week's time sheet
bb agent-calendar --week last          # last week's time sheet
bb agent-calendar log                  # today's work blocks, in order
bb agent-calendar log --day yesterday --json

Data

The plugin indexes turn history into its own SQLite database on the bb server and uses no external service. It backfills all visible threads, including archived ones, then re-reads only threads that changed. Hidden background threads are not shown, and deleted threads drop out. Times use your time zone in the app and the bb server's time zone in the CLI. Weeks start on Monday.

More from Nicolas Charpentier

Agent TracesSee where your agents' time goes, from every thread down to each command, tool call, and subagent of a turn. A turn opens as a timeline that splits the agent's time into waiting on you, tools, subagents, thinking, writing, and model time, and it grows live while the agent works. Select a call to see its exit code, output, and arguments, or jump to the reply that followed it in the chat. A Traces page in the sidebar compares your recent threads by active time, calls, and errors, and two turns can be compared phase by phase. Turns export as OpenTelemetry or an HTML snapshot, and the bb agent-traces command gives agents the same answers. Traces come from the thread history on your bb server; an OpenTelemetry collector is optional.390DependabotReviews GitHub Dependabot alerts grouped by dependency and sends grouped fixes to BB agents.18Disk UsageShows what's taking up disk space on the bb server host, ncdu-style, with drill-down by directory and a bb disk-usage CLI.65Gone FishingTurn the wait for your agent into a pixel-art fishing trip on top of the chat input. The pond fishes by itself while a turn runs, or you take the rod to hook, reel, and land each fish yourself. Water floods the chat input behind your text, and the fish swimming there are the ones that bite. Three maps hold 28 species, and the seasons follow your calendar. Your catches unlock new maps and gear for your angler, boat, and dog. Catches stay in a local database on the bb server and use no external service.28

More in Thread Management 85

Find, identify, organize, or archive threads.

View all