CLICommands
presence
snug presence <COMMAND>Presence occupancy and cognitive-state operations.
Subcommands
| Command | What it does |
|---|---|
contexts | Context policy administration |
heartbeat | Send a heartbeat into a context |
list | List present sessions in a context |
count | Show occupancy counts for a context |
state | Update cognitive state without full metadata |
nearby | Find nearby present sessions using geo |
leave | Leave a context, removing presence sessions |
last-seen | Show persistent last-seen data for a subject |
multiplex | Heartbeat multiple contexts in one request |
sweep | Reconcile expired members and apply idle/stale transitions (admin) |
Run snug presence <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug presence contexts create --file ./world-presence.json
snug presence contexts get --context ctx_world_123
snug presence sweep --context ctx_world_123
snug presence heartbeat --context ctx_world_123 --state available
snug presence heartbeat --context ctx_world_123 --session-id prs_42 --device-id phone-1 --active true
snug presence state --context ctx_world_123 --state busy
snug presence leave --context ctx_world_123 --session-id prs_42
snug presence multiplex --file ./multiplex.json
snug presence list ctx_world_123 --state available --kind agent
snug presence count --context ctx_world_123
snug presence nearby --context ctx_world_123 --lat 41.88 --lon -87.62 --radius-meters 5000
snug presence last-seen --subject user_123Next
- presence guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.