Repository navigation
v1.4.0 — markdown kanban boards, herdr plugin, themeable fonts
Amythest 1.4.0
Kanban boards become ordinary markdown notes you can edit by hand, amy gets a herdr plugin, and typography joins the theme system. Each tarball contains both binaries (amythest server, amy client).
Kanban boards are markdown notes
Board files were markdown wrappers around a JSON blob, followed by a derived rendering that went stale the moment you touched it. A board is now a note:
---
kanban: 4
name: personal
displayName: Personal
meta:
k_abc: {created: …, updated: …}
---
# In progress
## Fix the deploy pipeline ^k_abc
due:: 2026-09-10
priority:: p1
labels:: #infra #urgent
Free-form markdown description.
### Comments
- **2026-09-01T10:00:00Z — ada:** looks good# H1 headings are columns, ## H2 headings are cards (the trailing ^block-id is the stable card id), key:: value lines are the card's fields, labels are #tags, and the body is whatever markdown you want. Timestamps, attachments, audit entries and comment ids live in the frontmatter meta map so card bodies stay human.
- Hand edits are first-class. Retitle a heading, move a card by moving it under another column, or add a brand-new
## card— the server picks it all up. A hand-added card gets a stable id that is persisted on the next write. Unknown column headings fail with the list of valid ones. - Migration is automatic. Opening or listing a board converts it in place, from the previous JSON-in-markdown format (both the current and the predecessor marker style) or the short-lived whole-file YAML. Nothing to run.
cmd/kanban-migrate-checkis a read-only dry run that parses, re-renders and deep-compares a vault's boards without writing.
v4 reserves
#and##for structure, so headings inside card descriptions are demoted to###once, during migration.
amy — herdr plugin
herdr/ registers amy with herdr: a board pane running the full TUI in a split, and a quick-capture popup that takes one line and files it in today's daily note. Install with herdr plugin install base698/amythest/herdr, then bind the actions:
[[keys.command]]
key = "prefix+a"
type = "plugin_action"
command = "amythest.quick-capture"Opening the board is idempotent — it focuses a running board rather than splitting a second one, preferring the invoking workspace. amy capture also works headless (amy capture "call the vet"), so agents and scripts can file a task without the TUI.
amy — tasks while reading, and files that aren't task lists
- Act on tasks in the note reader. Checkbox lines in a note were plain text;
tnow grabs them,j/kwalk between them,spacetoggles andDruns the two-stage cancel-then-delete. Previously a task you were looking at could only be changed by going back to the tasks view and finding it again. Hstops collecting tasks from a file, settingtasks: falsein its frontmatter. The indexer always honored that opt-out but it had no terminal affordance, so a watchlist — a file whose checkboxes are a list, not a queue of work — kept filling the task views. The note stays readable, linked and searchable.
Themes — typography
Both surfaces read their type from two new theme tokens, font-body and font-mono. The stock look is unchanged; omarchy now uses a terminal mono stack across the notes site and the kanban board. Custom themes can set fonts like any other token:
themes:
typewriter:
light:
font-body: '"Courier Prime", "Courier New", monospace'Install
tar xzf amythest-1.4.0-<os>-<arch>.tar.gz
install -m 0755 amythest amy ~/bin/SHA-256 checksums in checksums.txt. Boards migrate on first open; no manual step.