A number of generators are included for managing and viewing the status of desks and their agents. Each of these are documented below.
Note that some old generators have been replaced:
|start- Replaced with
|ota- Replaced with
|fade- Replaced with
|doze- Replaced with
|wake- Replaced with
+trouble- This still exists but is deprecated, and is now an alias for
Print out the status of each installed desk.
Desks in Clay which aren't installed will be omitted.
/sys/kelvin- The version of
%zusethe desk is compatible with.
base hash- The merge base (common ancestor) between the desk and its upstream source.
%cz hash- The hash of the desk.
app status- May be
force on- The set of agents on the desk which have been manually started despite not being on the
force off- The set of agents on the desk which have been manually stopped despite being on the
publishing ship- The original publisher if the source ship is republishing the desk.
updates- May be
paused. Local means it will receive updates via commits on the local ship. Tracking means it will receive updates from the
source ship. Paused means it will not receive updates.
source desk- The desk on the
source aeon- The revision number of the desk on the
pending updates- Updates waiting to be applied due to incompatibility.
> +vats %base /sys/kelvin: [%zuse 420] base hash: ~ %cz hash: 0v6.2nqmu.oqm24.ighl6.n0gp9.s8res.feql1.dl8ap.isli3.jk0hu.acrd2 app status: running force on: ~ force off: ~ publishing ship: ~ updates: tracking source ship: ~zod source desk: %base source aeon: 3 pending updates: ~ :: %garden /sys/kelvin: [%zuse 420] base hash: ~ %cz hash: 0v1e.2h7hs.elq3g.1sdt7.qfga6.ganga.7p95j.aog44.8p5fe.kpr6v.7ai82 app status: running force on: ~ force off: ~ publishing ship: ~ updates: tracking source ship: ~zod source desk: %garden source aeon: 3 pending updates: ~
Print out the status of Gall agents on a desk.
Agents may either be
running. Nuked or unstarted agents which are not on the manifest are omitted.
> +agents %garden status: running %hark-system-hook status: running %treaty status: running %docket status: running %settings-store status: running %hark-store
Shut down all agents on a desk, archiving their states.
The tile in the homescreen (if it has one) will turn gray and say "Suspended" in the top-left corner. This generator does the same thing as selecting "Suspend" from an app tile's hamburger menu.
Revive all agents on a desk, migrating archived states.
All agents specified in
desk.bill which are suspended will be restarted. If updates to the agents have occurred since their states were archived, they'll be migrated with the state transition functions in the agent. This generator does the same thing as selecting "Resume App" from the app tile's hamburger menu.
Install a desk, starting its agents and listening for updates.
If it's a remote desk we don't already have, it will be fetched. The agents started will be those specified in the
desk.bill manifest. If it has a docket file, its tile will be added to the homescreen and its glob fetched. If we already have the desk, the source for updates will be switched to the ship specified.
It takes a
desk as its mandatory arguments. The desk may be installed with a different name specified in the optional
ship desk, =local desk
|install ~zod %bitcoin
|install our %webterm
|install ~zod %bitcoin, =local %foo
Uninstall a desk, suspending its agents and ignoring updates.
Note that this will not remove the tile or glob from the homescreen, so if the desk has a tile it should be uninstalled with the "Remove App" button in the tile's hamburger menu.
Pause updates on a desk.
The specified desk will stop tracking updates from its upstream source.
Resume updates on a desk.
Start tracking previously
|paused updates from a desk's upstream source.
Shut down an agent and permanently delete its state.
The default behaviour is to shut down the specified Gall agent and discard its state, similar to the now-deprecated
|fade generator. Note this irreversibly wipes the app's state. Additionally, if the optional
desk argument is
%.y, it takes a desk rather than an agent name and nukes every agent on the specified desk.
@tas, =desk ?
Nuke a single agent:
Nuke every agent on a desk:
|nuke %bitcoin, =desk &
Try to apply a kernel update.
%zuse's kelvin version has decreased, try to apply the update. If any desks are incompatible with the new
%zuse version, the update will fail. The update can be forced with the optional
force argument, in which case incompatible desks will be
set of desks to omit (and therefore suspend) can also be explicitly specified with the optional
, =force ?, =except (set desk)
Try to apply update, failing if blocked by any desks:
Force the update, suspending incompatible desks:
|bump, =force &
Apply kernel update, omitting and suspending the specified desks:
|bump, =except (silt ~[%bitcoin %webterm])
Adjust the state of a desk.
This allows you to stop and start agents on a desk, regardless of whether they're on the manifest. Stopped agents have their states archived. It can also suspend and revive the whole desk with the optional
desk (list [? dude:gall]), =liv ?
Start an agent:
|rein %bitcoin [& %btc-provider]
Stop an agent, archiving its state:
|rein %bitcoin [| %btc-wallet]
Stop one agent, start another:
|rein %bitcoin [| %btc-wallet] [& %btc-provider]
Suspend a desk:
|rein %bitcoin, =liv |
Revive a desk: