Commands

Every command accepts --config PATH (or LOOKOUT_CONFIG) before its name to choose the configuration file, and --help.

lookout act

Open, finish, dismiss, snooze or star an item.

Argument
item_id	Item id, as shown by inbox.
action	One of: open, done, dismiss, snooze, reopen, star, unstar.

Option
--hours	Snooze duration. Default: 24.0.
--until	Snooze until an ISO date and time.

lookout demo

Add demo items to try the dashboard.

lookout doctor

Check the database, the model endpoint and every source.

lookout explain

Say why an item has its priority and its place in the inbox.

Argument
item_id	Item id.

lookout export

Print every item as JSON lines.

lookout forget

Reset what Lookout learnt from your actions; items stay.

lookout inbox

List items, most urgent first.

Option
--priority, -p	P0 to P3, repeatable.
--channel	The topic: AI, Rust, ...
--source
--state	Default: new and seen. One of: new, seen, done, snoozed, dismissed, expired.
--starred	Only starred items.
--text
--limit	Default: 30.

lookout reassess

Recompute priorities after changing the stack or the thresholds (no model call).

lookout refile

File existing items again after changing categories (by rule, or queued for the model).

Option
--dry-run	Only say what would change.

lookout run

Fetch every source, then have the model read the new items.

lookout serve

Serve the API and the dashboard, and run on the configured schedule.

Option
--host	Address to listen on. Default: 127.0.0.1.
--port	Default: 8899.

lookout version

Print the installed version.