git:20260918.16670a7 to git:20260925.1360153

---

name: ground-commands

description: Every ground subcommand with a working example. Written by press from the modules that implement them.

---

```sh

# run by Claude Code on every hook event, the event's JSON on stdin:

ground < event.json

# search past hook events by wildcard pattern

# (see: ground events)

ground shovel PostToolUse "*pr create*"

# or dump a session's transcript:

ground shovel session ses90l3m

# post the pbt's attestations to their backends (make install does):

ground attest

# timing table:

ground profile

# one event, its phases and its worst runs:

ground profile PreToolUse

# perform a ritual, by its name when that names one:

ground ritual grove

# or by project and ritual when it does not:

ground ritual q.sbvh.nl boxsurvival

# end a live performance, by its ritual or by the handle on the status line:

ground abort grove

# the driver ground ritual forks, one per performance, by the performance id:

ground drive ground-coinflip-1786812152

# run by the script that starts a ritual's agent, what `claude --bg` printed on stdin:

ground bind ground-coinflip-1786812152 < started.txt

# every hook event ground answers to:

ground events

# set a .pbt in the one layout, or the pbt fixtures in a .d:

ground fmt controls/controls.pbt

ground fmt source/proto_test.d

# the author's tool, in the ground checkout: every case editable in a browser

ground author

# how much of each rate limit is used, and how the week got there:

ground usage

# strip the bulk out of the db (make install does):

ground decay

```