Desks, apps and 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 %gardenstatus: running %hark-system-hookstatus: running %treatystatus: running %docketstatus: running %settings-storestatus: running %hark-store
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])
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
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 &
Set the source of updates for the
%base desk (the kernel and core apps) to the specified ship. Automatic updates will be enabled, and any new updates available will be fetched and installed.
|ota ~marzod is equivalent to
|install ~marzod %kids, =local %base.
Pause updates on a desk.
The specified desk will stop tracking updates from its upstream source.
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:
Resume updates on a desk.
Start tracking previously
|paused updates from a desk's upstream source.
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.
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.
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.
Print out the status of a single installed desk.
Desks in Clay which aren't installed will be omitted. See the related
+vats command for details of the individual status fields.
> +vat %base%base/sys/kelvin: [%zuse 418]base hash: ~%cz hash: 0v2.r1lbp.i9jr2.hosbi.rvg16.pqe7u.i3hnp.j7k27.9jsgv.8k7rp.oi98qapp status: runningforce on: ~force off: ~publishing ship: ~updates: localsource ship: ~source desk: ~source aeon: ~pending updates: ~::
Print out the status of each installed desk.
Desks in Clay which aren't installed will be omitted. Also see the related
+vat command, which prints the status of a single desk rather than all desks.
/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 418]base hash: ~%cz hash: 0v6.2nqmu.oqm24.ighl6.n0gp9.s8res.feql1.dl8ap.isli3.jk0hu.acrd2app status: runningforce on: ~force off: ~publishing ship: ~updates: trackingsource ship: ~zodsource desk: %basesource aeon: 3pending updates: ~::%garden/sys/kelvin: [%zuse 418]base hash: ~%cz hash: 0v1e.2h7hs.elq3g.1sdt7.qfga6.ganga.7p95j.aog44.8p5fe.kpr6v.7ai82app status: runningforce on: ~force off: ~publishing ship: ~updates: trackingsource ship: ~zodsource desk: %gardensource aeon: 3pending updates: ~