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

docs: scrub stale glint-subcommand references (new/vault/config → flags)

2ba331e162dff15b80210484fc0edffbd7e71f16
humdrum <me@humdrum.me> · 2026-06-29 11:05

parent 3f49164d

docs: scrub stale glint-subcommand references (new/vault/config → flags)

The CLI moved from subcommands to flags (-n/-v/-c/-d); update README,
CHANGELOG, config-wizard descriptions, and doc-comments to match.

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

5 files changed

CHANGELOG.md +4 −3
@@ -31,9 +31,10 @@ - Glamour read preview (`Ctrl+P`), sharing the canvas column.
 - Fuzzy file picker (`Ctrl+F`) sorted by modified date with today's daily note
   floated to the top and a live preview pane.
 - Today's daily note (`Ctrl+D`), created on demand.
-- `glint new` starts a fresh document from anywhere; `glint new <name>` creates a
-  note under the inbox; `Ctrl+N` starts a new doc in the editor or a note from
-  the query in the picker. Unnamed buffers get a save-as prompt on `Ctrl+S`.
+- `glint -n` starts a fresh document in the current directory; `glint -n -i`
+  creates a note under the inbox; `Ctrl+N` starts a new doc in the editor or a
+  note from the query in the picker. Unnamed buffers get a save-as prompt on
+  `Ctrl+S`.
 - Open-while-dirty and quit are confirm-then-discard.
 
 ### Configuration
README.md +5 −5
@@ -64,22 +64,22 @@ | `Esc` | back to the editor |
 
 ## Configuration
 
-Run `glint config` for an interactive walkthrough that writes the file for you
+Run `glint -c` for an interactive walkthrough that writes the file for you
 (no hand-editing, daily-format presets instead of raw Go layouts). The settings
 live in `~/.config/glint/config.toml` (all keys optional):
 
 ```toml
-vault_dir     = ""           # the vault `glint vault` opens from anywhere (e.g. "~/Notes"); unset = current dir
-inbox_dir     = ""           # where `glint new` / save-as land; "" = working dir, relative = under it
+vault_dir     = ""           # the vault `glint -v` opens from anywhere (e.g. "~/Notes"); unset = current dir
+inbox_dir     = ""           # where `glint -n -i` / save-as land; "" = working dir, relative = under it
 daily_subdir  = "Daily"      # daily notes live in <vault>/<daily_subdir>/ (absolute path used as-is)
 daily_format  = "2006-01-02" # Go time layout for daily-note filenames
 theme         = "auto"       # auto | flexoki-light | flexoki-dark | charm  (auto detects macOS appearance)
 glamour_style = ""           # override the preview style; "" follows the theme
 ```
 
-**Two roots.** Bare `glint`, `glint new`, and `--daily` operate on the **working
+**Two roots.** Bare `glint`, `glint -n`, and `-d` operate on the **working
 directory** — the folder you launched from (or `$GLINT_VAULT` if set), so glint
-works in whatever repo you're in. **`glint vault`** opens the picker on your
+works in whatever repo you're in. **`glint -v`** opens the picker on your
 **configured `vault_dir`** from anywhere — set it to your notes vault to reach it
 without `cd`-ing there.
 
internal/config/config.go +4 −4
@@ -13,7 +13,7 @@ )
 
 // Config holds the user-tunable settings glint reads at startup.
 type Config struct {
-	VaultDir     string `toml:"vault_dir"` // the vault `glint vault` opens from anywhere
+	VaultDir     string `toml:"vault_dir"` // the vault `glint -v` opens from anywhere
 	DailySubdir  string `toml:"daily_subdir"`
 	DailyFormat  string `toml:"daily_format"`
 	GlamourStyle string `toml:"glamour_style"`
@@ -23,7 +23,7 @@ }
 
 // Default returns the built-in configuration used when no file is present.
 // VaultDir is empty by default: bare glint works in the current directory; set
-// vault_dir (config) to give `glint vault` a fixed vault to open from anywhere.
+// vault_dir (config) to give `glint -v` a fixed vault to open from anywhere.
 func Default() Config {
 	return Config{
 		DailySubdir: "Daily",
@@ -32,7 +32,7 @@ 		Theme:       "auto",
 	}
 }
 
-// WorkingDir is where bare `glint`, `glint new`, and `--daily` operate: the
+// WorkingDir is where bare `glint`, `glint -n`, and `-d` operate: the
 // $GLINT_VAULT pin if set, otherwise the current working directory.
 func (c Config) WorkingDir() string {
 	if v := os.Getenv("GLINT_VAULT"); v != "" {
@@ -44,7 +44,7 @@ 	}
 	return "."
 }
 
-// Vault is the directory `glint vault` opens from anywhere: the configured
+// Vault is the directory `glint -v` opens from anywhere: the configured
 // vault_dir, or the working directory when none is set.
 func (c Config) Vault() string {
 	if c.VaultDir != "" {
internal/config/config_test.go +1 −1
@@ -22,7 +22,7 @@ 	if d.Theme != "auto" {
 		t.Errorf("Theme = %q, want auto", d.Theme)
 	}
 	if d.VaultDir != "" {
-		t.Errorf("VaultDir default = %q, want empty (set vault_dir for `glint vault`)", d.VaultDir)
+		t.Errorf("VaultDir default = %q, want empty (set vault_dir for `glint -v`)", d.VaultDir)
 	}
 	if d.WorkingDir() == "" {
 		t.Error("WorkingDir should not be empty")
internal/configui/configui.go +3 −3
@@ -1,4 +1,4 @@
-// Package configui is the interactive `glint config` walkthrough: a huh form
+// Package configui is the interactive `glint -c` walkthrough: a huh form
 // that loads the current config, walks the user through every setting, and
 // writes the result to the config file.
 package configui
@@ -61,12 +61,12 @@ 					huh.NewOption("charm", "charm"),
 				).Value(&theme),
 			huh.NewInput().
 				Title("Vault directory").
-				Description("Where `glint vault` opens, from anywhere. Blank = none.").
+				Description("Where `glint -v` opens, from anywhere. Blank = none.").
 				Placeholder("/Users/you/Notes").
 				Value(&vaultDir),
 			huh.NewInput().
 				Title("Inbox directory").
-				Description("Where `glint new` and save-as land. Blank = the directory you run glint in.").
+				Description("Where `glint -n -i` and save-as land. Blank = the directory you run glint in.").
 				Value(&inboxDir),
 			huh.NewInput().
 				Title("Daily notes subfolder").