starboard · the verbs

this page as plaintext

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:, note:, sound:, room:: an app card’s source). Author mode on a plain stack only. Returns the card’s id; the card is selected (one undo step).

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 #

card. Answers at once; when it ends the card pins the new bounce (card.tune) and bounce_done (or bounce_failed) lands in activity.

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://, sound:, note:, world:, room:), or of a kind (text, track, tune, note…), or all of them with neither: each card’s id, kind, ref, text and place, in the stack’s order.

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://[#

]) pins one bounce of its song: re-pin it to the song’s newest in the store (the chip’s press, “newer bounce: use it”), or to 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 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 '{}'

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 /stacks/.stack.json (what Ctrl+S does).

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 1a9d475 docs/verbs: startune song.board (the song on StarBoard's board) and starboard card.find, regenerated (2026-11-03, the M2)

  • love-shared 7185c68 a 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 061fb13 StarTune'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:// links
  • love-shared 9658d24 docs/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 8109b86 the 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 a9bbe9b verb sheets: the launcher's and starboard's, regenerated after the merges (2026-10-24)

  • love-shared 42efbf4 the 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.

  • FAILlint/web-reference 12 Nov on tower
  • NOT RUNlint/verb-sheets 12 Nov on tower

Generated by tools/reference_pages.py from love-shared/docs/verbs/starboard.md; the twin bfaad079a7ce (434093 bytes). The words are a draft.