feat: implement core application model, add Lua engine support, and enable tag filtering with jump-to-top binding

Author: programmersd21

CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.4]
+
+### Added
+
+* **Vim Navigation**: Added support for `gg` in Vim Mode to instantly jump to the top of the task list, complementing the existing `G` shortcut for bottom navigation.
+
+### Fixed
+
+* **Help Footer Bug**: Resolved a bug where the "Show Help Footer" setting (in both `config.toml` and the settings menu) was being ignored. The footer now correctly hides help keybinding pills when disabled, providing more vertical space for task lists while still retaining critical action prompts (like delete/quit confirmation) for improved usability.
+
+### Changed
+
+* **Keybinding Refinement**: Removed the legacy hardcoded `g` shortcut for plugin reloading in the main list view, as it conflicted with Vim mode navigation. Plugin management remains accessible via the dedicated plugin menu and command palette.
+
 ## [1.2.3]
 
 ### Added

README.md

@@ -299,6 +299,7 @@ When enabled, the following classic Vim keys are activated for list navigation:
 - `j`: Move selection down
 - `k`: Move selection up
 - `G`: Jump to the bottom of the list
+- `gg`: Jump to the top of the list
 
 *Note: Standard arrow keys, `pgup`/`pgdown`, and `home`/`end` remain functional regardless of this setting.*
 

VERSION.txt

@@ -1 +1 @@
-1.2.3
+1.2.4

internal/app/model.go

@@ -855,18 +855,6 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 				return m, m.viewTransitionTickCmd()
 			}
 
-			// Plugin reload - single character keybinding only valid in ModeList
-			if km.String() == "g" && m.mode == ModeList {
-				if m.plugHost != nil {
-					_ = m.plugHost.LoadAll()
-					m.rebuildViews()
-					m.rebuildPaletteIndex()
-					m.statusText = "Plugins reloaded"
-					m.isErr = false
-					return m, m.loadTasksCmd()
-				}
-			}
-
 			if m.mode == ModeList {
 				// Dynamic view switching (1-9)
 				if len(km.String()) == 1 && km.String() >= "1" && km.String() <= "9" {
@@ -1343,6 +1331,7 @@ func (m *Model) renderFooter() string {
 	}
 
 	left := ""
+	// Critical prompts are always shown regardless of ShowHelp setting
 	switch m.mode {
 	case ModeConfirmDelete:
 		delLeft := lipgloss.NewStyle().Foreground(m.s.Theme.Bad).Background(m.s.Theme.Bg).Render("")
@@ -1356,40 +1345,46 @@ func (m *Model) renderFooter() string {
 		left = " " + quitPill + " " + makePill("y/enter confirm") + sep + makePill("n/esc cancel")
 	case ModeTagFilter:
 		left = " " + makePill("enter apply") + sep + makePill("esc cancel") + sep + makePill("ctrl+u clear")
-	case ModeDetail:
-		items := []string{
-			makePill(fk(m.km.Back) + " " + styles.IconBack + "back"),
-			makePill(fk(m.km.EditTask) + " " + styles.IconEdit + "edit"),
-			makePill(fk(m.km.Palette) + " " + styles.IconPalette + "palette"),
-			makePill(fk(m.km.Help) + " " + styles.IconHelp + "help"),
-			makePill(fk(m.km.Issues) + " " + styles.IconIssues + "issues"),
-			makePill(fk(m.km.Discussions) + " " + styles.IconDiscuss + "discussions"),
-			makePill(fk(m.km.Changelog) + " " + styles.IconChangelog + "changelog"),
-		}
-		left = " " + strings.Join(items, sep)
-	case ModeEditor:
-		left = " " + makePill("ctrl+s save") + sep + makePill("esc cancel") + sep + makePill("tab nav")
-	case ModePalette:
-		left = " " + makePill("enter select") + sep + makePill("esc/p cancel") + sep + makePill(styles.IconUp+styles.IconDown+" nav")
-	case ModeHelp:
-		left = " " + makePill("esc/q/"+fk(m.km.Help)+" cancel")
-	case ModeThemeMenu:
-		left = " " + makePill("enter select") + sep + makePill("esc/q/"+fk(m.km.CycleTheme)+" cancel") + sep + makePill(styles.IconUp+styles.IconDown+" nav")
-	case ModeSettings:
-		left = " " + makePill("esc/ctrl+s close") + sep + makePill("enter toggle") + sep + makePill(styles.IconUp+styles.IconDown+" nav")
-	case ModePluginMenu:
-		left = " " + makePill("enter detail") + sep + makePill("u uninstall") + sep + makePill("o open") + sep + makePill("r reload") + sep + makePill("p/"+fk(m.km.ManagePlugins)+" cancel")
 	default:
-		items := []string{
-			makePill(fk(m.km.Palette) + " " + styles.IconPalette + "palette"),
-			makePill(fk(m.km.NewTask) + " " + styles.IconNew + "new"),
-			makePill("f " + styles.IconTag + "tag"),
-			makePill(fk(m.km.ToggleStrike) + " " + styles.IconStrike + "done"),
-			makePill(fk(m.km.DeleteTask) + " " + styles.IconDelete + "delete"),
-			makePill(fk(m.km.Settings) + " settings"),
-			makePill(fk(m.km.Help) + " " + styles.IconHelp + "help"),
-		}
-		left = " " + strings.Join(items, sep)
+		// Only show help pills if ShowHelp is enabled in config
+		if m.cfg.App.ShowHelp {
+			switch m.mode {
+			case ModeDetail:
+				items := []string{
+					makePill(fk(m.km.Back) + " " + styles.IconBack + "back"),
+					makePill(fk(m.km.EditTask) + " " + styles.IconEdit + "edit"),
+					makePill(fk(m.km.Palette) + " " + styles.IconPalette + "palette"),
+					makePill(fk(m.km.Help) + " " + styles.IconHelp + "help"),
+					makePill(fk(m.km.Issues) + " " + styles.IconIssues + "issues"),
+					makePill(fk(m.km.Discussions) + " " + styles.IconDiscuss + "discussions"),
+					makePill(fk(m.km.Changelog) + " " + styles.IconChangelog + "changelog"),
+				}
+				left = " " + strings.Join(items, sep)
+			case ModeEditor:
+				left = " " + makePill("ctrl+s save") + sep + makePill("esc cancel") + sep + makePill("tab nav")
+			case ModePalette:
+				left = " " + makePill("enter select") + sep + makePill("esc/p cancel") + sep + makePill(styles.IconUp+styles.IconDown+" nav")
+			case ModeHelp:
+				left = " " + makePill("esc/q/"+fk(m.km.Help)+" cancel")
+			case ModeThemeMenu:
+				left = " " + makePill("enter select") + sep + makePill("esc/q/"+fk(m.km.CycleTheme)+" cancel") + sep + makePill(styles.IconUp+styles.IconDown+" nav")
+			case ModeSettings:
+				left = " " + makePill("esc/ctrl+s close") + sep + makePill("enter toggle") + sep + makePill(styles.IconUp+styles.IconDown+" nav")
+			case ModePluginMenu:
+				left = " " + makePill("enter detail") + sep + makePill("u uninstall") + sep + makePill("o open") + sep + makePill("r reload") + sep + makePill("p/"+fk(m.km.ManagePlugins)+" cancel")
+			default:
+				items := []string{
+					makePill(fk(m.km.Palette) + " " + styles.IconPalette + "palette"),
+					makePill(fk(m.km.NewTask) + " " + styles.IconNew + "new"),
+					makePill("f " + styles.IconTag + "tag"),
+					makePill(fk(m.km.ToggleStrike) + " " + styles.IconStrike + "done"),
+					makePill(fk(m.km.DeleteTask) + " " + styles.IconDelete + "delete"),
+					makePill(fk(m.km.Settings) + " settings"),
+					makePill(fk(m.km.Help) + " " + styles.IconHelp + "help"),
+				}
+				left = " " + strings.Join(items, sep)
+			}
+		}
 	}
 
 	right := ""

internal/lua/engine.go

@@ -55,7 +55,7 @@ func (e *Engine) SetupKairoAPI(L *lua.LState) {
 	L.SetField(kairo, "notify", L.NewFunction(e.luaNotify))
 
 	// Meta
-	L.SetField(kairo, "version", lua.LString("1.2.3"))
+	L.SetField(kairo, "version", lua.LString("1.2.4"))
 
 	// Set as global
 	L.SetGlobal("kairo", kairo)

internal/ui/tasklist/model.go

@@ -41,6 +41,8 @@ type Model struct {
 
 	DeletingTaskID string
 	DeleteProgress float64
+
+	lastKey string // For tracking key sequences like 'gg'
 }
 
 func New(s styles.Styles, vimMode bool, km keymap.Keymap) Model {
@@ -90,38 +92,57 @@ func (m Model) Update(msg tea.Msg) (Model, tea.Cmd) {
 	case tea.KeyMsg:
 		switch x.String() {
 		case "up", "k":
+			m.lastKey = ""
 			if x.String() == "k" && !m.vimMode {
 				break
 			}
 			if m.sel > 0 {
 				m.sel--
 			}
 		case "down", "j":
+			m.lastKey = ""
 			if x.String() == "j" && !m.vimMode {
 				break
 			}
 			if m.sel < len(m.tasks)-1 {
 				m.sel++
 			}
 		case "pgup":
+			m.lastKey = ""
 			m.sel -= max(1, m.height-4)
 			if m.sel < 0 {
 				m.sel = 0
 			}
 		case "pgdown":
+			m.lastKey = ""
 			m.sel += max(1, m.height-4)
 			if m.sel > len(m.tasks)-1 {
 				m.sel = len(m.tasks) - 1
 			}
 		case "home":
+			m.lastKey = ""
 			m.sel = 0
 		case "end", "G":
+			m.lastKey = ""
 			if x.String() == "G" && !m.vimMode {
 				break
 			}
 			if len(m.tasks) > 0 {
 				m.sel = len(m.tasks) - 1
 			}
+		case "g":
+			if !m.vimMode {
+				break
+			}
+			if m.lastKey == "g" {
+				m.sel = 0
+				m.lastKey = ""
+			} else {
+				m.lastKey = "g"
+				return m, nil // Don't reset lastKey yet
+			}
+		default:
+			m.lastKey = ""
 		}
 	}
 	return m, nil