>_
worktale university

university / course 08

Reference Bookmark this

Reference.

Every command, every flag, every config key, every keyboard shortcut, every file path. Designed for quick lookup, not learning — if you're starting out, begin at Foundations.

Commands

worktale

Alias for worktale dash. Opens the TUI dashboard.

worktale init

Import history of the current git repo, register it, install post-commit hook.

worktale dash

Open the interactive TUI (Overview / Daily Log / History / AI Sessions).

worktale today

Quick summary of today (commits, lines, files, coding time).

worktale status [--all-repos]

One-line status. --all-repos aggregates every tracked repo.

worktale log [--days N] [--since DATE] [--until DATE] [-f json|csv|markdown]

Browse daily activity log. Format flags emit structured output.

worktale digest [--date YYYY-MM-DD] [-f json|markdown]

Generate a digest for today (default) or a specific date.

worktale note "<text>"

Append a note to today's user_notes. Shows up in digest + Daily Log.

worktale publish [--date YYYY-MM-DD]

Publish a saved digest to Worktale Cloud. Requires login.

worktale standup [--days N] [--format slack|markdown|email|html] [--all-repos]

Generate an AI-written recap post.

worktale repos [list | rename <name> <new> | move <name> <path> | remove <name>]

Manage tracked repos.

worktale batch <dir> [--since N[mdy]] [--auto] [--annotate] [--install-hooks] [--exclude <regex>]

Recursively find and import every git repo under <dir>.

worktale hook <install|uninstall|status> [<repo-path>]

Manage the post-commit hook in a repo.

worktale nudge <--install|--uninstall|--check>

Shell-profile reminder at end of day.

worktale session <add|list|stats> [flags]

AI session management. add inserts a session row; pass --write-note to also append the --note text to today's daily log in one call (v1.5.0+). list and stats support --format.

worktale config <get|set|unset> [key] [value]

Read/write config values.

worktale cloud <login|logout|status|profile>

Cloud login and identity.

worktale export [--format json|csv] [--dir <path>]

Dump the full database to JSON or CSV files.

worktale diagnose

Print version, OS, config (redacted), DB info. Paste into bug reports.

worktale capture <repo-path>

Internal: called by git post-commit hook. You don't run this directly.

worktale --version

Print CLI version.

worktale --help [command]

Show help; pass a command for command-specific help.

Global flags

FLAGMEANING
-f, --formatOutput format (log/digest/session): json, csv, markdown
--days NLookback window in days
--since <d>Start date: ISO or Ndays/Nweeks/Nmonths (e.g. 3m)
--until <d>End date (inclusive)
--date <d>Specific date for single-day commands
--all-reposAggregate across every tracked repo
-h, --helpShow help and exit
-v, --versionPrint version and exit

Config keys

KEYTYPEDEFAULT / NOTES
nudgeTimestring"17:00" HH:MM
autoDigestOnNudgebooltrue — auto-generate digest when nudge fires (v1.5.0+)
timezonestring"auto" or IANA tz
ai.providerstring"template" or "ollama"
ai.modelstring|nullOllama model name
ai.ollamaUrlstringhttp://localhost:11434
git.userEmailstring|nullauto-detect
git.userEmailOverridestring|nullfilter imports by author email
showCaptureConfirmationboolfalse
cloudEnabledboolmanaged by login/logout
cloudTokenstring|nullbearer token
cloudApiUrlstring|nullself-host override
appearance.themestring"dark" or "light" (desktop)
appearance.fontScalenumber0.9 / 1.0 / 1.15 / 1.3 (desktop)

TUI keyboard shortcuts

1 / 2 / 3 / 4Overview / Daily Log / History / AI Sessions
TabCycle tabs forward
d / DGenerate digest and exit
p / PPublish today and exit
eEdit notes (Daily Log)
← →Prev/next day (Daily Log)
qQuit

Desktop keyboard shortcuts

On macOS, use Cmd instead of Ctrl.

Ctrl+KCommand palette
Ctrl+1…8Switch view (1=Overview ... 8=Settings)
Ctrl+NNew note
Ctrl+DGenerate today's digest
Ctrl+SSave draft (Digest view)
Ctrl+Shift+PPublish current digest
Ctrl+RRefresh from DB
Ctrl+BToggle sidebar
← →Prev/next day (Daily Log)
EscClose dialog

File paths

~/.worktale/Worktale home directory
~/.worktale/data.dbMain SQLite database
~/.worktale/config.jsonGlobal config
~/.worktale/config.json.bakLast config backup (auto-created)
<repo>/.git/hooks/post-commitPer-repo Worktale hook
~/.claude/projects/...Claude Code transcripts (plugin source)
~/.codex/sessions/YYYY/MM/DD/Codex rollout JSONLs
~/.copilot/session-state/<id>/Copilot CLI events

Database schema

Every row is local. Nothing here is transmitted unless you explicitly publish.

TABLEPURPOSE
reposEvery tracked repo: path, name, first_seen, last_synced
commitsOne row per commit: sha, msg, author, timestamp, stats, branch, tags
daily_summariesOne per (repo, date): counts, notes, ai_draft, published flag
file_activityPer (repo, path, date): change counts for module aggregation
ai_sessionsOne per AI session: provider, model, tool, cost, tokens, tools_used