Tags

Tags are free-form labels you attach to time entries. They're useful for cutting the same project's hours into views like "internal vs client meetings", "deep work vs review", or "frontend vs backend".

Tags do not change rates or which project the entry belongs to. They're purely a way to filter and group later.

Creating tags

Tags belong to your organization, so any teammate can use active tags. Create them from the CLI:

hourdini tags create review --color 5

You can also create, rename, archive, and restore tags through the REST API or MCP tools. See the API reference or AI agents.

Tagging an entry

Tags can be attached when you start a timer or log time from the CLI:

hourdini start "acme dashboard" --tag review --tag frontend
hourdini log "acme dashboard" 45m --tag review

In the web app, open Time, select an entry, and use the entry panel's Tags field to add or remove existing tags. Entries that are already on an invoice cannot be edited.

Filtering by tag

The Time list has a tag filter when your organization has active tags. The filter shows entries with the selected tag.

The CLI accepts repeated --tag values on hourdini list; entries matching any selected tag are returned:

hourdini list --period month --tag review --tag frontend

REST list and summary endpoints accept tag_id filters. Analytics in the web app currently groups by client or project, not by tag.

Archiving a tag

Archived tags drop out of new pickers, but existing entries keep their history. Archive or restore tags through REST or MCP. The CLI can list archived tags with:

hourdini tags list --archived

Next