▍ humdrum codex / glint v1.0.2
license AGPL-3.0

docs: capture TASK-017 — route TUI file-manager 'open' (Yazi/ranger/lf/nnn) to glint

2b871cf7c4547ba06b585cd662b17c3dcd68aef0
humdrum <me@humdrum.me> · 2026-06-29 09:40

parent 21633ab4

1 files changed

- → Route-open-to-glint-in-terminal-file-managers-Yazi-ranger-lf-nnn.md +31 −0
@@ -0,0 +1,31 @@
+---
+id: TASK-017
+title: Route 'open' to glint in terminal file managers (Yazi/ranger/lf/nnn)
+status: "\U0001F7E6 Backlog"
+assignee: []
+created_date: '2026-06-29 16:40'
+labels:
+  - feature
+  - release-2
+dependencies: []
+priority: low
+ordinal: 17000
+---
+
+## Description
+
+<!-- SECTION:DESCRIPTION:BEGIN -->
+Adoption feature, terminal-file-manager layer (distinct from TASK-015 $EDITOR and TASK-016 OS associations). When a user hits 'open' (not 'open externally') on a .md/.txt file in a TUI file manager, route it to glint. Each manager has its own opener config, independent of $EDITOR:
+  - Yazi: ~/.config/yazi/yazi.toml — an [opener] entry { run = 'glint "$@"', block = true } plus [open] rules for name='*.md' and mime='text/*'. block=true runs glint in the foreground. Overrides Yazi's default $EDITOR opener for text only.
+  - ranger: rifle.conf rule (mime ^text → glint "$@").
+  - lf: 'cmd open' script dispatching text/markdown to glint.
+  - nnn: nuke/opener script entry.
+Ship documented snippets in the README, and optionally a glint -c step that detects an installed manager and offers to append the rule (idempotent, reversible). Keep $EDITOR untouched so code editing is unaffected.
+<!-- SECTION:DESCRIPTION:END -->
+
+## Acceptance Criteria
+<!-- AC:BEGIN -->
+- [ ] #1 README documents opener snippets for Yazi (and ranger/lf/nnn) routing text/markdown 'open' to glint
+- [ ] #2 Yazi rule uses block=true and overrides only text/markdown, leaving $EDITOR alone
+- [ ] #3 Optional: glint -c detects an installed file manager and offers to add the rule idempotently
+<!-- AC:END -->