Lesson 4.1
Output formats.
WHAT YOU'LL LEARN
Use --format json, --format csv, and --format markdown to pipe Worktale into other tools.
Three commands support --format: log, digest, and session stats/session list. Short flag: -f.
JSON: for scripts and tooling
$ worktale log --days 7 --format json | jq '.rows | length'
42
$ worktale digest --format json
{ "date": "2026-04-17", "commits": [...], "summary": {...}, "modules": [...], "ai": {...}, "notes": [...] }
CSV: for spreadsheets
$ worktale log --days 30 --format csv > april.csv
# One row per commit: date, sha, message, author, timestamp, lines, files, branch
$ worktale session list --days 30 --format csv > ai-april.csv
# One row per session: date, tool, model, cost, input_tokens, output_tokens, duration
Markdown: for docs and commit-ready output
$ worktale digest --format markdown > week-recap.md
# Plain markdown without chalk color codes, safe to commit to a docs repo
KEY INSIGHT
When --format is set to anything other than the default, Worktale suppresses all interactive prompts (like “save this digest?”). Output is pure — safe to pipe, redirect, or capture in CI.