Expand description
taskfast events poll — single-page read over GET /agents/me/events.
The SDK also offers stream_events (long-running cursor chase);
the polling subcommand stays one-shot because a JSON-lines follow
mode doesn’t mix with the envelope-per-invocation contract. Live
tailing lives in super::stream over WebSocket instead.
§Cursor persistence
With --cursor absent, the previous invocation’s next_cursor is
read from <config_dir>/events.cursor so back-to-back polls in an
agent loop resume past the last batch without orchestrator
bookkeeping. After a successful poll the new next_cursor is
written back. --cursor - and TASKFAST_NO_CURSOR_STATE=1 both
disable read+write for ad-hoc inspection runs that shouldn’t
mutate the persisted offset.