▍ humdrum codex / glint v1.0.2

Reframe spec: editor-first (v1), vault TUI as later layer

736cd3bf89f8a020ff2c72d09a1e5f7d675f13d0
humdrum-tiv <45084903+humdrum-tiv@users.noreply.github.com> · 2026-06-27 20:24

parent a3f7acb7

Reframe spec: editor-first (v1), vault TUI as later layer

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

1 files changed

docs/superpowers/specs/2026-06-27-glint-design.md +18 −7
@@ -6,12 +6,22 @@ **Stack:** Go + Bubbletea (MVU) + Lipgloss + Glamour
 
 ## What it is
 
-A pretty terminal markdown editor with glow-style rendering, used as an
-Obsidian-vault companion (not a replacement — the Obsidian GUI stays primary).
-Open a file, edit it with **live inline styling** (bold renders bold, headings
-colored/bold, links colored — while the raw markup characters stay visible),
-save it. Plus: jump to today's daily note, fuzzy-pick any vault file, and toggle
-a full glamour-rendered read view.
+A pretty terminal markdown editor with glow-style rendering. Open a file, edit
+it with **live inline styling** (bold renders bold, headings colored/bold, links
+colored — while the raw markup characters stay visible), save it. Plus: jump to
+today's daily note, fuzzy-pick a file, and toggle a full glamour-rendered read
+view.
+
+Two faces, built in order:
+
+1. **Editor (v1, this spec).** A micro-like editor for editing/previewing any
+   markdown doc from anywhere — `glint notes.md`, `glint ~/foo/README.md`,
+   `glint --daily`. Vault-agnostic: works on a loose file or inside the vault.
+   This is the core and the v1 deliverable.
+2. **Vault TUI (later version).** An Obsidian-vault companion layer on top of the
+   editor — browse/navigate/search the vault, wikilink follow, tags, graph
+   (not a replacement; Obsidian GUI stays primary). Out of scope for v1; the v1
+   architecture is built so this bolts on without rework.
 
 Motivation: existing vault TUIs (ekphos, clin-rs, basalt, kimun) almost fit but
 hardcode the wrong things. ekphos was closest, but: (1) its editor leaves plain
@@ -23,7 +33,8 @@
 ## Non-goals (v1)
 
 Wikilink follow, in-content search, graph view, tag browsing, multi-pane layout,
-sort persistence, vim modality. Modeless editing only. These may come later.
+sort persistence, vim modality. Modeless editing only. Most of these belong to
+the **Vault TUI (later version)**, not the editor — see "What it is".
 
 ## Editing model (decided)