Skip to content

v1.4.0 — markdown kanban boards, herdr plugin, themeable fonts

Choose a tag to compare

@base698 base698 released this 26 Sep 02:16
· 21 commits to main since this release

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-check is 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; t now grabs them, j/k walk between them, space toggles and D runs 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.
  • H stops collecting tasks from a file, setting tasks: false in 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.