Offline Mode and Queue Management

How Offline Queueing Works

When the Pyvorin API is unreachable, events are stored locally in:

~/.pyvorin/queue/

Each event is a JSON file with a timestamp and unique ID.

Queue Configuration

Config Key	Default	Description
queue_dir	~/.pyvorin/queue	Storage directory.
max_queue_size	1000	Max files before rotation.
queue_retention_days	30	How long to keep old events.

Manual Sync

pyvorin sync

Drains the offline queue and sends events to the server. Use this after restoring connectivity.

Disabling Offline Mode

pyvorin config-set offline_queue_enabled false

When disabled, events that cannot be sent immediately are dropped rather than queued.

Monitoring Queue Health

pyvorin doctor

Shows the current queue size and whether the queue directory is writable.