starboard · the verbs
The board: its stacks and cards, the pieces’ storyboard and pinboard, the board’s terminal. 31 verbs in 9 categories: 8 undoable, 5 read-only. The app-verbs protocol (love-shared/docs/app-verbs.md): staros-tap starboard verbs lists them live, staros-tap starboard verb <name> '<json>' runs one, activity --since N reads the journal. Loaded headless from starboard by scripts/verb_inventory.lua.
board
board.move — low, undoable
A card into a lane (its board_lane), before another or last.
| argument | type | notes |
|---|---|---|
before |
string | |
lane |
string | required |
shot |
string | required |
staros-tap starboard verb board.move '{"shot": "…", "lane": "…"}'
board.open — low, palette word board
Open a piece’s storyboard (its stack.json) as the app’s stack.
| argument | type | notes |
|---|---|---|
slug |
string | required |
staros-tap starboard verb board.open '{"slug": "…"}'
board.send — medium
Send the storyboard as it stands, as a stack draft against its board blob.
staros-tap starboard verb board.send '{}'
board.sound — low, undoable
A sound of the store (its sha16) under shot after as a track card the applier places as a cue (role cue, bed or room); remove takes it off.
| argument | type | notes |
|---|---|---|
after |
string | required |
label |
string | |
remove |
boolean | |
role |
string | one of cue, bed, room |
sound |
string | required |
volume |
number |
staros-tap starboard verb board.sound '{"sound": "…", "after": "…"}'
board.state — low, read-only
The storyboard as the applier reads it: lanes, order, sections; the draft’s state.
staros-tap starboard verb board.state '{}'
card
card.add — low, undoable, palette word add
Add a card: text (its body), x, y in world units (default: a walk of the canvas, 380 px a column, six to a row), w, h (240 x 160), script (starspell), kind (text | shape | image | note | world | sound | room; a ref’s scheme when absent) and ref (world:
| argument | type | notes |
|---|---|---|
h |
number | |
kind |
string | |
layer |
string | |
ref |
string | |
script |
string | |
text |
string | |
w |
number | |
x |
number | |
y |
number |
staros-tap starboard verb card.add '{}'
card.bounce — low
Bounce a song card’s StarTune song into the sound store from the board, StarTune open or not (love-shared sound/bounce.lua: its CLI over the saved song, the same bytes StarTune makes), its section’s bars for a #
| argument | type | notes |
|---|---|---|
id |
string | required |
staros-tap starboard verb card.bounce '{"id": "…"}'
card.delete — medium, undoable
Delete the selected card(s) (one undo step).
staros-tap starboard verb card.delete '{}'
card.find — low, read-only
The open stack’s cards whose source is ref (an app card’s: tune://
| argument | type | notes |
|---|---|---|
kind |
string | |
ref |
string |
staros-tap starboard verb card.find '{}'
card.focus — low, palette word focus
Pan to a card by id and select it.
| argument | type | notes |
|---|---|---|
id |
string | required |
staros-tap starboard verb card.focus '{"id": "…"}'
card.tune — low, undoable, palette word tune
A song card (tune://bounce (a sha16), so the board’s animatic plays what the render will (one undo step).
| argument | type | notes |
|---|---|---|
bounce |
string | |
id |
string | required |
staros-tap starboard verb card.tune '{"id": "…"}'
link.add — low, undoable, palette word link
Link two cards by id, from → to, a labelled edge (label: the link’s word, default next; kind: goto by default), as the Link tool’s drag does. A card never links to itself, and a pair is linked once. Author mode on a plain stack only (one undo step).
| argument | type | notes |
|---|---|---|
from |
string | required |
kind |
string | |
label |
string | |
to |
string | required |
staros-tap starboard verb link.add '{"from": "…", "to": "…"}'
edit
edit.redo — low, palette word redo
Redo the last undone change.
staros-tap starboard verb edit.redo '{}'
edit.undo — low, palette word undo
Undo the last change to the stack (the user’s or an agent’s: one step each).
staros-tap starboard verb edit.undo '{}'
links
link.open — low
Open a link wherever it belongs (shared.links): here, another app’s tap or a spawn, a soft handoff on iOS.
| argument | type | notes |
|---|---|---|
uri |
string | required |
staros-tap starboard verb link.open '{"uri": "…"}'
open — low
A link handed to this StarBoard (board://, pins://, stack://): its storyboard, the shot’s card focused.
| argument | type | notes |
|---|---|---|
uri |
string | required |
staros-tap starboard verb open '{"uri": "…"}'
piece
piece.config — medium
Point this StarBoard at the piece media server(s): {servers = [{base, token, write_token}]} or {base, token}; force lets a desktop take a phone’s. Tokens are stored, never echoed.
| argument | type | notes |
|---|---|---|
base |
string | |
force |
boolean | |
servers |
array | |
token |
string | |
write_token |
string |
staros-tap starboard verb piece.config '{}'
piece.media — low, read-only
The media client’s status and each shot card’s poster state on the current stack.
staros-tap starboard verb piece.media '{}'
piece.sync — low
Ask the phone’s session for a sync of the snapshot now; its status.
staros-tap starboard verb piece.sync '{}'
pinboard
note.move — low, undoable
Move a note after a paragraph on the pinboard, as a drop does.
| argument | type | notes |
|---|---|---|
after |
string | required |
note |
string | required |
staros-tap starboard verb note.move '{"note": "…", "after": "…"}'
pin.place — low, undoable
Place a pin after a paragraph or a note on the pinboard, as a drop does.
| argument | type | notes |
|---|---|---|
after |
string | required |
pin |
string | required |
staros-tap starboard verb pin.place '{"pin": "…", "after": "…"}'
stack
stack.open — medium, palette word open
Open a stack by name (the current one is saved first); card focuses a card in it.
| argument | type | notes |
|---|---|---|
card |
string | |
name |
string | required |
staros-tap starboard verb stack.open '{"name": "…"}'
stack.save — medium, palette word save
Save the current stack to
staros-tap starboard verb stack.save '{}'
stack.state — low, read-only
The stack’s name, its cards’ count, the mode (author/play), the view (canvas/graph), the selection, whether it is unsaved, and the terminal’s state.
staros-tap starboard verb stack.state '{}'
terminal
terminal.focus — low
Move keyboard focus to the terminal (showing it) or back to the app; toggles with no to.
| argument | type | notes |
|---|---|---|
to |
string | one of terminal, app |
staros-tap starboard verb terminal.focus '{}'
terminal.hide — low
Hide the drawer; the session stays attached and the agent keeps streaming.
staros-tap starboard verb terminal.hide '{}'
terminal.open — low, palette word term
Show the task’s terminal (the drawer) and start an agent in it on first creation: claude, code (starsage) or shell.
| argument | type | notes |
|---|---|---|
agent |
string | one of claude, guide, code, shell, greenkeeper, warden, stoker, scribe, herald, busker, porter |
staros-tap starboard verb terminal.open '{}'
terminal.screen — low, read-only
What the task’s terminal shows now: its visible lines, title, size, the link’s state.
staros-tap starboard verb terminal.screen '{}'
terminal.send — low, palette word ask
Type a line into the task’s terminal and press Enter (enter=false types without it): hand the agent there a request.
| argument | type | notes |
|---|---|---|
enter |
boolean | |
text |
string | required |
staros-tap starboard verb terminal.send '{"text": "…"}'
view
view.fit — low, palette word fit
Fit every card into the view.
staros-tap starboard verb view.fit '{}'
view.toggle — low, palette word view
Switch between the canvas and the graph view (what G does).
staros-tap starboard verb view.toggle '{}'
The work on this page: the commits of the last 30 days on its sources, the work open against them, its checks
love-shared 1a9d475docs/verbs: startune song.board (the song on StarBoard's board) and starboard card.find, regenerated (2026-11-03, the M2)
love-shared 7185c68a song's new bounce plays at the next look; an app keeps its bounces as jobs (the scripts program's phase 3b, 2026-11-02 night, the M2)love-shared 061fb13StarTune's music by name (the scripts program's phase 3b, 2026-11-02 night, the M2): tune://<song>[#<section>] the song's newest bounce or a section's bed; one bounce for every app; tune:// linkslove-shared 9658d24docs/verbs: take.to_sound writes a take's words beside its sound; StarLore's note.new takes a kind; StarBoard's agents, regenerated by scripts/verb_sheet.py (the takes reach the stories, 2026-11-02 night, the M2)
love-shared 8109b86the keepers, K4-K6 (2026-10-31 night, the M2): agents/worlding.lua (the stoker and the scribe in the registry: eight launchers), scripts/tap_conformance.py (the bare `open`, the links' verb every app answers, admitted by name: the one undotted verb; the scribe's finding task://staros/the-bare-link-verb-open-…), scripts/verb_inventory.lua (StarLore's editor verbs join on attach, so the sheet lists note.*, play.*, guide.*, feed.*, media.* as the running app answers), docs/verbs/ regenerated (StarLore 95 verbs with note.new; StarBoard with card.add and link.add)
love-shared a9bbe9bverb sheets: the launcher's and starboard's, regenerated after the merges (2026-10-24)
love-shared 42efbf4the home everywhere (S1): agents/drawer.lua, a task's terminal in an app with fixed chrome — a strip along an edge holding a Home, a dragged height remembered, ctrl+` opens and hops, shift+escape hides (attached), terminal.* verbs on the app's registry; _drawer_test (45); verb_inventory and verb_sheet know starboard (docs/verbs/starboard, 26 verbs); CLAUDE.md
The work record as of , from the fold on tower.
Nothing open against these sources.
- FAIL
lint/web-reference - NOT RUN
lint/verb-sheets
Generated by tools/reference_pages.py from love-shared/docs/verbs/starboard.md; the twin bfaad079a7ce (434093 bytes). The words are a draft.