tt — a Charm-native front-end for tock

tt makes it easy to review, edit, and backfill time tracked with the tock CLI. tock stays the source of truth; tt only reads and writes through it.

Install

make install            # builds bin/tt, symlinks it into ~/.local/bin

Once published to the tap:

brew install humdrum/tap/tt

Requires tock on PATH. tt menu's full-screen actions (watch/list/analyze) hand the terminal over to tock.

Commands

tt timeline [date|today|yesterday] — spatial day grid: fixed slot rows, range-select to add an entry, edit/delete logged sessions, per-project colors. (Alias: tt tui.)
tt day [date|today|yesterday] — list view with per-project totals and Enter-to-edit. ←/→ change day.
tt menu — guided menu over tock: start, stop, current, continue, note, tag, report, list, last, watch, analyze.

In the add/edit form, project, description, and tags autocomplete from your tock history (Ctrl+E accepts a suggestion). Values stay free text. History comes from the tock sqlite DB when that backend is active, otherwise from tock last.

Config

~/.config/ticktock/config.json (all optional):

key	default	meaning
`slot_minutes`	`30`	grid row height in minutes (min 5)
`grid_start`	`07:00`	earliest grid hour (auto-expands to data)
`grid_end`	`21:00`	latest grid hour (auto-expands to data)
`project`	`""`	default project for a new entry

Build & test

make build      # -> bin/tt
make test
make vet

Release

Homebrew release scaffolding lives in scripts/brew-release.sh and deploy/deploy.env.example (copy to deploy/deploy.env, gitignored). The formula is a source build (depends_on "go"); publishing is a manual step.

License

AGPL-3.0-or-later. See LICENSE.