missionctl suite · macOS + Linux

timectl

Time Tracking from your Terminal

Start and stop timers from the terminal. Weekly bar chart. Pairs with diaryctl to show how you spent your day.

Download — Free Get the Bundle — $39

timectl — today
$ timectl start "Fix auth bug" --project diaryctl
▶ Started: Fix auth bug (diaryctl)
  09:14:32 — running

$ timectl stop
■ Stopped: Fix auth bug (diaryctl)
  09:14:32 → 11:03:17 — 1h 48m 45s

$ timectl today
  09:00–10:30  1h 30m  Plan sprint       [work]
  10:45–12:00  1h 15m  Fix auth bug      [diaryctl]
  14:00–15:45  1h 45m  Write tests       [diaryctl]
  ──────────────────────────────────────
  Total: 4h 30m█

The terminal app

Type timectl — this is the real TUI with made-up demo data. C switches the colour theme.

timectl

 timectl · today                           ● Landing page (missionctl)  01:42:01                           Sun 18 Oct
 ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
 ╭─ Last 30 days ─────────────╮ ╭─ Today ───────────────────────────────────────────────────────────────────────────╮
 │ M T W T F S S              │ │ ▌ ▶ 14:18  Landing page                             missionctl  ████████   1h 42m │
 │           ◼ ▪              │ │     13:05  Review pull requests                     missionctl  █████▌░░   1h 10m │
 │ ◼ ■ ■ ■ ■ ▪ ▪              │ │     12:15  Invoice Nordlicht → Prepare invoice f…  client work  ███▏░░░░      40m │
 │ ◼ ■ ◼ ■ ■ ◼ ▪              │ │     11:40  Standup                                        team  █▏░░░░░░      15m │
 │ ◼ ■ ■ ■ ■ ▪ ▪              │ │     10:50  Inbox zero                                           ██▍░░░░░      30m │
 │ ◼ ■ ◼ ■ ■ ◼ ◼              │ │                                                                                   │
 │                            │ │                                                                                   │
 │ less ▪ ◼ ■ more            │ │                                                                                   │
 │                            │ │                                                                                   │
 │ today                      │ │ ───────────────────────────────────────────────────────────────────────────────── │
 │ 4h 17m                     │ │ Total  4h 17m                                                                     │
 │                            │ │ Goal   ████████████▉░░░░░░░░░░░  4h 17m / 8h  53%                                 │
 ╰────────────────────────────╯ ╰───────────────────────────────────────────────────────────────────────────────────╯







  s stop  n start  ? help  q quit  T tasks  e notes  d delete  u undo  / filter  ←/→/t day  w week  v stats        1/5

Features

Start/Stop Timers

timectl start TASK and timectl stop. Errors clearly if a timer is already running. Simple, fast, no friction.

Live TUI

Running timer updates every second in the header. Switch between today, week bar chart, and stats views with a single key.

Weekly Bar Chart

Horizontal bar chart showing hours per day. See your rhythm across the week at a glance.

diaryctl Integration

Time logs feed directly into your daily diary entry. "You spent 3.5h on diaryctl, 1h in meetings."

Command Palette

Press ":" and type an action by name — start timer, stop, week breakdown — instead of memorizing shortcuts. Live-filtered as you type.

Command Reference

timectl — cheatsheet
# Start a timer
$ timectl start "Fix auth bug" --project myapp

# Stop the running timer
$ timectl stop

# Check current timer
$ timectl status

# Time log for today
$ timectl today

# Week bar chart
$ timectl week

# Log last N days
$ timectl log --days 7

# TUI (live timer + views)
$ timectl tui

# Start MCP server
$ timectl mcp

MCP Tools

Available via timectl mcp

Tool	Description
start_timer	Start a timer with task name and optional project tag
stop_timer	Stop the running timer, returns task name and duration
get_time_log	Time entries for a date or date range with total duration
get_time_stats	Breakdown by task/project, daily average, streak for last N days

Know where your time goes.

Free and open source. Or get the lifetime Bundle for all 9 tools — launch special: -30% with code L4uNch26.

Download — Free Get the Bundle — $39