v1.2.3

- **Bugfix (TUI):** Fix spacebar handling in the TUI editor and filter. Some terminals emit `tea.KeySpace` instead of `tea.KeyRunes` for the spacebar; the TUI now treats `KeySpace` as a typed space so spaces are inserted into editor commands and list filters consistently. Added headless tests `TestEditorTypingSpaceKeyInCommands` and `TestFilterModeSpaceKeyAppendsSpace` to prevent regressions.
- **Quality:** Ran `gocyclo` (no functions with complexity > 10 found) and `golangci-lint` (0 issues).
- **Docs:** Update `docs/tui.md` and add release notes for the fix.

Author: VoxDroid

CHANGELOG.md

@@ -3,6 +3,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## v1.2.3 - 2026-02-03
+
+- **Bugfix (TUI):** Fix spacebar handling in the TUI editor and filter. Some terminals emit `tea.KeySpace` instead of `tea.KeyRunes` for the spacebar; the TUI now treats `KeySpace` as a typed space so spaces are inserted into editor commands and list filters consistently. Added headless tests `TestEditorTypingSpaceKeyInCommands` and `TestFilterModeSpaceKeyAppendsSpace` to prevent regressions.
+- **Quality:** Ran `gocyclo` (no functions with complexity > 10 found) and `golangci-lint` (0 issues).
+- **Docs:** Update `docs/tui.md` and add release notes for the fix.
+
 ## v1.2.2 - 2026-01-17
 
 - Bugfix: Preserve comma-containing commands passed via a single `-c` flag (e.g., PowerShell `Select-Object` usage such as `Get-ComputerInfo | Select-Object OsName, OsVersion, OsArchitecture`). The CLI no longer splits a single `-c` value on commas — instead we use repeatable `-c` flags (`StringArray`) and ensure a single quoted `-c` is preserved literally.

README.md

@@ -21,13 +21,13 @@ _Record. Automate. Run._
 
 ---
 
-### Why not just an alias or a shell script? 
+### Why not just an alias or a shell script?
 
 - **Aliases** - Fast to add, but per‑shell and per‑machine. They live in whichever RC file you edited and are invisible to others unless you share your dotfiles manually. Hard to discover across many short‑lived aliases.
 - **Shell scripts / dotfiles** - Flexible and shareable, but scattered. To share you need a repo, copy instructions, or a package. Scripts don’t include author/metadata, versioned history for the command itself, or a simple, interactive discovery UI.
 - **git** - Excellent for source control and team collaboration, but file‑centric: commits operate on files, not on discoverable, runnable command sets. Git workflows require manual commits and searches; they aren’t optimized for quick ad hoc rollbacks or interactive discovery of hundreds of tiny workflows.
 
-### How krnr helps 
+### How krnr helps
 
 - **Global (per‑user, per‑machine)** - krnr stores a single, versioned SQLite registry in your user config path (see `KRNR_HOME`), so any shell on your machine (bash, zsh, PowerShell, TUI, CI sessions) can access the same saved workflows without per‑shell setup.
 - **Cross‑machine** — Use `krnr export` to produce a portable SQLite file (whole DB or selected sets) and `krnr import` on another machine. Exports are single files with metadata, timestamps, authorship, and configurable conflict policies (`--on-conflict` rename|skip|overwrite|merge) to avoid clobbering local setups.

RELEASE_NOTES/GITHUB_v1.2.3.md

@@ -0,0 +1,7 @@
+# v1.2.3 - 2026-02-03
+
+- Bugfix: Fix spacebar behavior in the TUI. Some terminals produce a `KeySpace` event which previously was ignored; the TUI now treats it as a typed space in both the editor and list filter, restoring expected typing behavior.
+- Tests: Add headless UI tests to cover `KeySpace` in filter and editor flows.
+- Quality: Ran `gocyclo` and `golangci-lint` — no actionable issues found.
+
+Upgrade note: This is a backward-compatible TUI fix; no DB or CLI-breaking changes.

cmd/tui/ui/editor.go

@@ -41,6 +41,12 @@ func (m *TuiModel) handleEditorKey(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
 	if msg.Type == tea.KeyBackspace || msg.Type == tea.KeyDelete {
 		return m.handleEditorBackspace()
 	}
+	// Treat KeySpace like typing a rune ' ' so real terminals that produce
+	// a KeySpace are handled the same as test harnesses that use KeyRunes.
+	if msg.Type == tea.KeySpace {
+		// synthesize a KeyRunes message with a single space rune
+		return m.handleEditorRunes(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{' '}})
+	}
 	if msg.Type == tea.KeyRunes {
 		return m.handleEditorRunes(msg)
 	}

cmd/tui/ui/input.go

@@ -51,7 +51,7 @@ func applyListFilterKey(m *TuiModel, msg tea.KeyMsg) (tea.Model, tea.Cmd, bool)
 	// update the live filter text and apply filtering only when the filter
 	// text actually changed (typing/backspace/esc). Navigation keys should
 	// not reapply the items and reset the selection.
-	if msg.Type == tea.KeyRunes || msg.Type == tea.KeyBackspace || msg.Type == tea.KeyDelete || msg.Type == tea.KeyEsc {
+	if msg.Type == tea.KeyRunes || msg.Type == tea.KeySpace || msg.Type == tea.KeyBackspace || msg.Type == tea.KeyDelete || msg.Type == tea.KeyEsc {
 		updateListFilterText(m, msg)
 		applyFilterItems(m)
 	}
@@ -67,6 +67,8 @@ func updateListFilterText(m *TuiModel, msg tea.KeyMsg) {
 		for _, ru := range msg.Runes {
 			m.listFilter += string(ru)
 		}
+	case tea.KeySpace:
+		m.listFilter += " "
 	case tea.KeyBackspace, tea.KeyDelete:
 		if len(m.listFilter) > 0 {
 			r := []rune(m.listFilter)
@@ -139,7 +141,7 @@ func applyFilterItems(m *TuiModel) {
 
 func handleDispatchFilterMode(m *TuiModel, msg tea.KeyMsg) (tea.Model, tea.Cmd, bool) {
 	switch msg.Type {
-	case tea.KeyRunes:
+	case tea.KeyRunes, tea.KeySpace:
 		return handleFilterModeRunes(m, msg)
 	case tea.KeyBackspace, tea.KeyDelete:
 		return handleFilterModeBackspace(m, msg)
@@ -162,8 +164,12 @@ func handleDispatchFilterMode(m *TuiModel, msg tea.KeyMsg) (tea.Model, tea.Cmd,
 }
 
 func handleFilterModeRunes(m *TuiModel, msg tea.KeyMsg) (tea.Model, tea.Cmd, bool) {
-	for _, ru := range msg.Runes {
-		m.listFilter += string(ru)
+	if msg.Type == tea.KeySpace {
+		m.listFilter += " "
+	} else {
+		for _, ru := range msg.Runes {
+			m.listFilter += string(ru)
+		}
 	}
 	applyFilterItems(m)
 	return m, nil, false

cmd/tui/ui/menu.go

@@ -351,8 +351,6 @@ func (m *TuiModel) renderMenu() string {
 	return b.String()
 }
 
-
-
 func (m *TuiModel) renderMenuSingleCol() string {
 	var b strings.Builder
 	// Compute maximum item width so we can pad items to a consistent length

cmd/tui/ui/tui_filter_test.go

@@ -52,6 +52,33 @@ func TestFilterTypingUpdatesList(t *testing.T) {
 	}
 }
 
+func TestFilterModeSpaceKeyAppendsSpace(t *testing.T) {
+	reg := &fakeRegistry{items: []adapters.CommandSetSummary{{Name: "alpha", Description: "A"}, {Name: "beta", Description: "B"}}}
+	ui := modelpkg.New(reg, &fakeExec{}, nil, nil)
+	_ = ui.RefreshList(context.Background())
+	m := NewModel(ui)
+	m.Init()()
+	// enter filter mode
+	m1, _ := m.Update(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{'/'}})
+	m = m1.(*TuiModel)
+	if !m.filterMode {
+		t.Fatalf("expected filter mode to be active")
+	}
+	// type 'b'
+	m2, _ := m.Update(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{'b'}})
+	m = m2.(*TuiModel)
+	// press SPACE key (KeySpace)
+	m3, _ := m.Update(tea.KeyMsg{Type: tea.KeySpace})
+	m = m3.(*TuiModel)
+	if m.listFilter != "b " {
+		t.Fatalf("expected listFilter to be 'b ' after pressing KeySpace, got %q", m.listFilter)
+	}
+	// the list Title should include the space
+	if m.list.Title != "Filter: b " {
+		t.Fatalf("expected title to include space, got %q", m.list.Title)
+	}
+}
+
 func TestFilterMatchesTags(t *testing.T) {
 	reg := &fakeRegistry{items: []adapters.CommandSetSummary{{Name: "s1", Description: "", Tags: []string{"db", "alpha"}}, {Name: "s2", Description: "", Tags: []string{"net"}}}}
 	ui := modelpkg.New(reg, &fakeExec{}, nil, nil)

cmd/tui/ui/tui_test.go

@@ -646,6 +646,48 @@ func TestEditorTypingKAndSpaceInCommands(t *testing.T) {
 	}
 }
 
+func TestEditorTypingSpaceKeyInCommands(t *testing.T) {
+	full := adapters.CommandSetSummary{Name: "one", Description: "First", Commands: []string{""}}
+	reg := &replaceFakeRegistry{items: []adapters.CommandSetSummary{{Name: "one", Description: "First"}}, full: full}
+	ui := modelpkg.New(reg, &fakeExec{}, nil, nil)
+	_ = ui.RefreshList(context.Background())
+	m := NewModel(ui)
+	m.Init()()
+	m1, _ := m.Update(tea.WindowSizeMsg{Width: 80, Height: 20})
+	m = m1.(*TuiModel)
+	m2, _ := m.Update(tea.KeyMsg{Type: tea.KeyEnter})
+	m = m2.(*TuiModel)
+	// open in-TUI editor
+	m3, _ := m.Update(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{'e'}})
+	m = m3.(*TuiModel)
+	if !m.editingMeta {
+		t.Fatalf("expected editor to be open")
+	}
+	// cycle to commands field (tab until commands)
+	for i := 0; i < 10 && m.editor.field != 5; i++ {
+		m4, _ := m.Update(tea.KeyMsg{Type: tea.KeyTab})
+		m = m4.(*TuiModel)
+	}
+	// ensure we're editing the first command
+	if m.editor.cmdIndex != 0 {
+		t.Fatalf("expected cmdIndex 0, got %d", m.editor.cmdIndex)
+	}
+	// type 'k', then SPACE using KeySpace, then 'x'
+	m5, _ := m.Update(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{'k'}})
+	m = m5.(*TuiModel)
+	m6, _ := m.Update(tea.KeyMsg{Type: tea.KeySpace})
+	m = m6.(*TuiModel)
+	m7, _ := m.Update(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune{'x'}})
+	m = m7.(*TuiModel)
+	if m.editor.commands[m.editor.cmdIndex] != "k x" {
+		t.Fatalf("expected command to contain typed runes 'k x', got %q", m.editor.commands[m.editor.cmdIndex])
+	}
+	// ensure cmdIndex didn't move due to 'k'
+	if m.editor.cmdIndex != 0 {
+		t.Fatalf("expected cmdIndex to remain 0 after typing 'k', got %d", m.editor.cmdIndex)
+	}
+}
+
 func TestDeleteFromDetailPromptsAndDeletesWhenConfirmed(t *testing.T) {
 	full := adapters.CommandSetSummary{Name: "one", Description: "First", Commands: []string{"echo hi"}}
 	reg := &replaceFakeRegistry{items: []adapters.CommandSetSummary{{Name: "one", Description: "First"}}, full: full}

docs/tui.md

@@ -46,6 +46,10 @@ Accessibility & theming
 - High-contrast mode: toggle with `T` inside the TUI. This switches to a high-contrast color scheme to improve readability in low-vision or busy terminal themes.
 - Menu modal: press `m` to open the **Menu** modal which contains actions like `Export database`, `Import database`, `Import set`, `Install`, `Uninstall`, and `Status`. Export/Import invoke the existing adapter-backed logic so the TUI delegates to the same exporter/importer paths as the CLI.
 
+Key handling and spaces
+- Note: different terminals may report the spacebar as either a `KeyRunes` event with a single `' '` rune or as a `KeySpace` event. The TUI now handles both forms consistently for editor input and the list filter so pressing the spacebar reliably inserts a space character regardless of environment. Tests were added to prevent regressions.
+
+
 CI
 - We added a GitHub Actions workflow `.github/workflows/tui-ci.yml` to run `go test ./... -v` across Ubuntu, Windows and macOS. The workflow validates headless UI tests and the rest of the test suite on PRs and pushes to `main`.
 Accessibility

internal/version/version.go

@@ -3,4 +3,4 @@ package version
 
 // Version is set at build time via -ldflags "-X github.com/VoxDroid/krnr/internal/version.Version=<value>"
 // The default is a development placeholder.
-var Version = "v1.2.2"
+var Version = "v1.2.3"