<!-- GENERATED by starlens/site/tools/reference_pages.py from the engine's sources: do not edit; run it. -->

[[nav: reference | here=verbs]]

<div class="doc">

<!-- GENERATED by love-shared/scripts/verb_sheet.py from the app's registry (scripts/verb_inventory.lua): do not edit; run it. -->

# starboard · the verbs

<p class="plain"><a href="../../verbs/starboard.md">this page as plaintext</a></p>

*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:<scene>, note:<slug>, sound:<sha16>, room:<id>: 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 #<section> 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://<song>, sound:<sha16>, note:<slug>, world:<scene>, room:<id>), 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://<song>[#<section>]) 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.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 <save dir>/stacks/<name>.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 '{}'

<details class="changes">
<summary>The work on this page: the commits of the last 30 days on its sources, the work open against them, its checks</summary>

[[timeline: src=love-shared/docs/verbs/starboard.md | kinds=commit | days=30]]

[[work: open | src=love-shared/docs/verbs/starboard.md]]

[[work: checks | rows=lint/web-reference,lint/verb-sheets]]

</details>

<nav class="pager"><span></span><a href="../../">The reference</a><span></span></nav>

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

</div>
