Screens

Onboarding

Shown on first launch when ~/.tide/settings.json does not exist. Lets you pick which agents to configure. Generates a minimal no-auth profile for each selected agent and writes it to ~/.tide/settings.json.

Key	Action
↑ / ↓ / j / k	Move cursor
Space / Enter	Toggle selected agent
c	Confirm — write profiles and proceed to task list
Esc / q	Skip — proceed without selecting any agents

Task List (default)

The main screen. Shows all tasks with status, schedule, last result, and pending sync state.

Workspace selector

The header subtitle shows the current workspace (▾ <workspace-name> or ▾ all workspaces). Press Tab to cycle through all known workspaces and "all workspaces". The selector is hidden when only one workspace has tasks.

When multiple workspaces are visible ("all workspaces" mode), tasks are grouped by workspace with a section header between groups.

Keyboard shortcuts:

Key	Action
↑ / ↓ / j / k	Navigate tasks
Enter	Open Task Detail
Tab	Cycle workspace (current → others → all workspaces)
c	Create new task file in the current workspace (falls back to launch directory when "all workspaces" is selected)
r	Run selected task now
e	Toggle enable/disable
l	Open latest run for selected task
x	Open Runs list for selected task
d	Delete selected task (with confirmation)
Ctrl+S	Sync selected task (if pending)
S	Sync all pending tasks
n	Open Notifications
s	Open Settings
q / Ctrl+C	Quit

Status badges:

Badge	Meaning
running	Task is currently executing
loaded	Registered with launchd, not currently running
disabled	Plist has Disabled: true — registered but will not fire
not loaded	Plist is missing or was never bootstrapped — re-enable to restore

Sync badges:

Badge	Meaning
● pending create	.md file exists but no plist — press Ctrl+S to register
● pending update	A plist-encoded field changed in the .md — press Ctrl+S to apply
○ orphaned	Plist exists but its source .md was deleted or moved — press Ctrl+S to remove

Task Detail

Full view of a single task's config and live status. Shows all frontmatter fields, live launchd state, and the last run result.

Key	Action
r	Run task now
k	Kill the running process (shown only when status is running)
e	Toggle enable/disable
Ctrl+E	Open .md file in $EDITOR (shows error toast if no source file)
Ctrl+S	Sync task (shown only when a sync is pending)
l	Open latest run for this task
x	Open Runs list
d	Delete task
n	Open Notifications
Esc / q	Back

Runs

Two-level screen for browsing a task's execution history and logs. Press x to open it from the task list or task detail.

Runs list

Shows all runs newest-first. Each row displays start time, exit code badge, duration, and attempt count.

Key	Action
↑ / ↓ / j / k	Navigate runs
Enter / →	Open run detail
+ / ]	Show more runs
- / [	Show fewer runs
r	Refresh
n	Open Notifications
s	Open Settings
Esc / q	Back to task

Run detail

Shows metadata for the selected run (time, exit code, duration, attempts, and parent run ID for follow-ups) and its log output — scoped to that run only. Tide log lines are dimmed; markdown in Claude output is rendered.

Key	Action
Tab	Switch between OUTPUT and STDERR tabs
f	Start a follow-up run (completed runs only)
o	Open log file in $EDITOR (read-only)
+ / ]	Show more log lines
- / [	Show fewer log lines
n	Open Notifications
s	Open Settings
← / Esc / q	Back to runs list

Log output is refreshed live (via fs.watch) while the task is running, indicated by ● live. For completed runs the output is loaded once.

Notifications

Review pending task-completion notifications. Each entry shows task name, run time, exit code, and output summary.

Key	Action
↑ / ↓ / j / k	Navigate notifications
Enter	Open run detail and mark notification as read
d	Dismiss selected notification
r	Mark all notifications as read
Ctrl+R	Clear all read notifications
c	Clear all notifications (with confirmation)
s	Open Settings
Esc / q	Back

Pressing Esc does not clear notifications — you must press c explicitly.

Settings

Configure auto-refresh interval. Profiles (agent auth config) are displayed read-only — edit ~/.tide/settings.json directly to manage them. Changes are written to ~/.tide/settings.json on Enter.

Key	Action
← / →	Change value
Enter	Save settings
Esc / q	Back without saving
j / k	Scroll