CLICommands
almanac
snug almanac <COMMAND>World time, calendars, weather, and content windows.
Subcommands
| Command | What it does |
|---|---|
create | Create a world from a JSON definition file |
list | List worlds |
get | Get a world definition |
delete | Delete a world |
now | Compute the current environment snapshot for a world |
clock | Virtual clock control |
weather | Weather queries |
windows | Content window management |
subscribe | Provision a subscription channel for a world or region |
transitions | Read recent content-window transition fanout events for a world |
until-phase | Count down to the next occurrence of a named day phase |
Run snug almanac <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug almanac create --file ./eldoria.json
snug almanac list
snug almanac get --world-id world_eldoria
snug almanac delete --world-id world_eldoria
snug almanac now --world-id world_eldoria --region northreach
snug almanac clock now --world-id world_eldoria
snug almanac clock pause --world-id world_eldoria
snug almanac clock resume --world-id world_eldoria
snug almanac clock set --world-id world_eldoria --dilation 12.0 --effective-from 2026-07-01T00:00:00Z
snug almanac windows positions --world-id world_eldoria
snug almanac weather forecast --world-id world_eldoria --region northreach --virtual-hours 48
snug almanac windows create --world-id world_eldoria --file ./daily-shop.json
snug almanac windows list --world-id world_eldoria
snug almanac windows preview --world-id world_eldoria --window-id win_daily_shop --count 21
snug almanac subscribe --world-id world_eldoria --region northreach
snug almanac transitions --world-id world_eldoria --limit 50
snug almanac until-phase --world-id world_eldoria --phase dawn
snug almanac weather override --world-id world_eldoria --file ./overrides.json
snug almanac weather overrides --world-id world_eldoriaNext
- almanac 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.