<!-- 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. -->

# starplot · the verbs

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

*The chronicle: its rooms and docks, the transport, the agenda, the work fold. 10 verbs in 5 categories: 0 undoable, 2 read-only. The app-verbs protocol (`love-shared/docs/app-verbs.md`): `staros-tap starplot verbs` lists them live, `staros-tap starplot verb <name> '<json>'` runs one, `activity --since N` reads the journal. Loaded headless from `starplot/dashboard` by `scripts/verb_inventory.lua`.*

## calendar

### `agenda.add` — low, palette word `add`

Add a calendar event from natural language ("standup tomorrow 9a 30m") through the agenda pane.

| argument | type | notes |
|---|---|---|
| `text` | string | required |

    staros-tap starplot verb agenda.add '{"text": "…"}'

## fold

### `work.refresh` — low, palette word `refresh`

Drop the work fold's cache so every pane reads the file again.

    staros-tap starplot verb work.refresh '{}'

## panes

### `shell.close` — low, palette word `close`

Close the focused pane.

    staros-tap starplot verb shell.close '{}'

### `shell.panes` — low, read-only, palette word `panes`

Every pane on screen: its leaf, index, id, title, and which is focused.

    staros-tap starplot verb shell.panes '{}'

### `shell.split` — low, palette word `split`

Split the focused pane: a new leaf to its right or below.

| argument | type | notes |
|---|---|---|
| `side` | string | one of right, bottom |

    staros-tap starplot verb shell.split '{}'

## rooms

### `dock.toggle` — low, palette word `dock`

Show or hide a dock by id (needs_you, term): a pane along an edge, on demand.

| argument | type | notes |
|---|---|---|
| `id` | string | required |

    staros-tap starplot verb dock.toggle '{"id": "…"}'

### `room.list` — low, read-only, palette word `rooms`

The rooms the shell document names, and the one on screen.

    staros-tap starplot verb room.list '{}'

### `room.open` — low, palette word `room`

Open a room by id: its layout takes the screen, its views as they were.

| argument | type | notes |
|---|---|---|
| `id` | string | required |

    staros-tap starplot verb room.open '{"id": "…"}'

## time

### `transport.now` — low, palette word `now`

Clear the Chronicle's cursor: the lanes read now.

    staros-tap starplot verb transport.now '{}'

### `transport.scrub` — low, palette word `scrub`

Scrub the Chronicle's cursor to a unix time (seconds): the lanes and the footer read the estate then.

| argument | type | notes |
|---|---|---|
| `at` | number | required |

    staros-tap starplot verb transport.scrub '{"at": 0}'

<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/starplot.md | kinds=commit | days=30]]

[[work: open | src=love-shared/docs/verbs/starplot.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/starplot.md`; the twin `bfaad079a7ce` (434093 bytes). The words are a draft.*

</div>
