launchers.toml.example

# Your own rows for Collie's launcher menu. Copy to your plugin config dir, next to `.env`:
#   cp launchers.toml.example "$(herdr plugin config-dir herdr.collie)/launchers.toml"
#
# This file configures ONE thing: your launcher rows — the dashboard's Launch section and the
# switcher sheet's own Launch section (swipe up from a pane), which list the same rows. Each row
# is a button that types its `command` verbatim into a fresh shell and sends Enter — the command
# is run exactly as written. This file IS the allowlist: `POST /api/launch` only accepts a
# `command` string that matches a row here exactly, so nothing absent from this file can be
# launched from a phone.
#
# WHERE a tap opens depends on WHERE you tap it, not on the row:
#   - From the dashboard: a NEW Space (labelled with the row's label).
#   - From a pane, in the switcher: a new TAB in that pane's own Space, beside it.
#
# `cwd` is where the tap opens. Pin one and it wins everywhere. Leave it out and it means "here":
# the dashboard opens it in your home dir, a pane opens it in THAT PANE'S OWN cwd — so one
# cwd-less row follows you around instead of always landing at the top of your checkout.
#
# The command owns its own lifetime: a self-closing peek (it prints and exits, closing its
# pane) takes the whole Space or tab with it when you quit — Herdr deletes a Space whose last
# pane closed, and a tab whose last pane closed — while something like `htop` sits there until
# you close it.
#
# On a crew (several machines, one phone-facing lead — CREW_PROTOCOL.md), each machine reads
# its OWN copy of this file. A row you declared only on your laptop only launches on your
# laptop, whichever machine's dashboard or pane you tapped it from.
#
# Edits are picked up live — no restart. Reload the page to see them.
#
# Fields: `command` (required, the shell line typed verbatim), `label` (optional; defaults to
# the command's first whitespace-separated token), `cwd` (optional; absent means "here", as
# described above — leading `~` is expanded to your home dir when you do pin one).
#
# With every row commented out (as shipped) neither surface appears — no Launch section on the
# dashboard and none in the switcher, exactly as shipped. A malformed row is dropped with a
# warning — never the whole file — and a later row for the same `command` replaces the earlier
# one in place.

# A self-closing peek with an explicit label — it runs, shows output, and when you quit the
# Space or tab goes away with it. No cwd, so it opens wherever you tapped it: your home dir from
# the dashboard, the current pane's own folder from the switcher.
# [[launchers]]
# command = "rumen-peek"
# label = "Runs & quota"

# A pinned cwd — this one always opens in the same directory, dashboard or switcher alike.
# `label` omitted, so it defaults to "htop".
# [[launchers]]
# command = "htop"
# cwd = "~/dev/collie"