Amythest 1.0.0

Amythest 1.0.0

First release. Amythest is a self-hosted notes, tasks, and kanban server for an Obsidian-style markdown vault — plus amy, an interactive terminal client. Each tarball contains both binaries (amythest server, amy client); pure Go, no runtime dependencies.

amythest — the server

• Notes: markdown vault rendering with wikilinks, tags, graph/content index, and FTS5 full-text search. ⌘K search modal with slash commands (/today jumps to today's daily note; registry is one entry per new command). Raw-note API for programmatic clients.
• Tasks: Obsidian Tasks-compatible engine over your vault — emoji metadata (📅 due, ⏳ scheduled, 🛫 start, 🔁 recurrence, ✅/❌, priorities), a query language (not done, due before tomorrow, path includes, group by, …), and write APIs for toggle, due date, 🔁 recurrence, priority, triage, cancel → purge (two-stage delete), and quick-add (daily note created on demand). All writes are optimistic-locked against the file hash and atomically committed under a vault lock. Recurrence understands the full notation, including every N weeks on <day> and completion-relative … when done.
• Kanban: boards live as markdown files inside the vault. Six-lane workflow (triage → backlog → ready → in progress → verify → done), cards with markdown descriptions and live checkboxes, comments, attachments, labels/priority/due/blocked, cross-board moves with a crash-safe journal, done-archive with restore, and per-board file locking.
• Integrations: share/text capture, base tables, and an MCP server (bearer token) exposing notes, tasks, and kanban tools to AI agents.
• Single static binary with the web UI embedded. Binds loopback by default — pair with Tailscale Serve or any TLS proxy. Prometheus metrics at /metrics.

amy — the terminal client

• Today view: everything due — overdue and due-today vault tasks merged with due or focused kanban cards — beside a shimmering ASCII amethyst. x reveals what you finished today, and completions can be undone in place.
• Views: 1 today · 2 tasks · 3 boards · 4 notes, with vim-style / n N search everywhere.
• Doing things: space toggles tasks and card checklist items (Obsidian ✅ done-dates, recurrence-aware with catch-up feedback), d archives a card, m opens a move picker (lanes and other boards), D deletes with confirmation (tasks cancel first, then purge; cards delete permanently — archive included), + quick-adds a task (daily note by default, any searched note otherwise) or a card into the focused column.
• Editing: e edits a task's due date and 🔁 repeat rule in two prompts, or opens a whole card in $EDITOR (title, status, priority, due, labels, blocked, description — only changed fields are sent). c comments on cards.
• Notes: search the vault, read notes with soft wrapping, follow [[wikilinks]] with tab/enter.
• Agent hand-off: a sends any note or kanban card — metadata, body, comments — to a running herdr coding agent as framed context.
• Config via ~/.config/amythest/cli.yaml + env; session cache shared with the bundled API scripts.

Install

Download the tarball for your platform, then:

tar xzf amythest-1.0.0-<os>-<arch>.tar.gz
install -m 0755 amythest amy ~/bin/   # or anywhere on PATH

Server quickstart and configuration (vault path, kanban env vars, amy endpoint setup) are in the README. SHA-256 checksums in checksums.txt.