Skip to content
Documentation Time Turner
CLI reference /

Time Turner

Search screen history and retrieve screenshots.

On this page

Usage

muesli-cli time-turner history --last 6h --app "Google Chrome"
muesli-cli time-turner search --query "release plan" --limit 20
# Replace <id> with a returned capture ID.
muesli-cli time-turner get <id>
muesli-cli time-turner get <id> --output screen.png

Requires history saved by Time Turner in the Mac app.

history: oldest first. Use --last 30m, 6h, or 1d, or --from and --until with ISO-8601 timezones. --app matches an exact app name or bundle ID, case-insensitively.

search: newest first. Filters: --query, --from, --until, --app. Default --limit: 50 for search, 100 for history; range: 1 to 1000.

get: returns OCR and metadata. --output saves a PNG to a new file.

Pagination: use meta.nextCursor when meta.hasMore is true. history retains its filters; search requires you to repeat them. Cursors are command-specific.

History is sampled. Text may outlive screenshots; gaps do not establish inactivity.

Explore Time Turner