feat: release v1.1.5

Implement shell completions, help command, and improved configuration loading.

- feat(cli): add `kairo completion` command with support for bash, zsh, fish, and powershell
- feat(cli): add `kairo help` command for subcommand discovery
- feat(config): implement multi-location config loading (including `~/.kairo/` and `~/.config/kairo/`)
- feat(ui): add task ID to detail view metadata
- feat(ui): add "NEW TASK" and "EDIT TASK" titles to the editor
- feat(ui): add editor shortcut toolbar/hints
- feat(ui): improve active tab styling with accent background
- feat(ui): make rainbow logo animation toggleable via config
- chore: update version to 1.1.5 in VERSION.txt and lua engine
- chore: update goreleaser configuration with Homebrew support
- docs: update README with installation and completion instructions
- docs: update CHANGELOG with 1.1.5 release notes
- fixes #9
- fixes #8

Author: programmersd21

.gitignore

@@ -58,6 +58,10 @@ data/
 # Local config (user-specific)
 config.toml
 
+# tasks metdata
+tasks.json
+tasks.md
+
 # =========================
 # 🔐 Optional (future-proof)
 # =========================

.goreleaser.yaml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://goreleaser.com/static/schema.json
 version: 2
 
 project_name: kairo
@@ -28,24 +29,22 @@ builds:
 
     mod_timestamp: "{{ .CommitTimestamp }}"
 
-    ldflags:
-      - -s -w
-      - -X github.com/programmersd21/kairo/internal/buildinfo.Version={{ .Version }}
-      - -X github.com/programmersd21/kairo/internal/buildinfo.Commit={{ .ShortCommit }}
-      - -X github.com/programmersd21/kairo/internal/buildinfo.Date={{ .CommitDate }}
+    ldflags:
+      - -s -w
+      - -X github.com/programmersd21/kairo/internal/buildinfo.Version={{ .Version }}
+      - -X github.com/programmersd21/kairo/internal/buildinfo.Commit={{ .ShortCommit }}
+      - -X github.com/programmersd21/kairo/internal/buildinfo.Date={{ .CommitDate }}
 
 archives:
   - id: default
-    formats:
-      - tar.gz
+    formats: [tar.gz]
 
     format_overrides:
       - goos: windows
-        formats:
-          - zip
+        formats: [zip]
 
     name_template: >-
-      {{ .ProjectName }}_{{ .Os }}_{{- if eq .Arch "amd64" }}x86_64{{ else }}{{ .Arch }}{{ end }}
+      {{ .ProjectName }}_{{ .Os }}_{{ if eq .Arch "amd64" }}x86_64{{ else }}{{ .Arch }}{{ end }}
 
     files:
       - LICENSE
@@ -67,10 +66,29 @@ changelog:
       - '^docs:'
       - '^test:'
       - '^chore:'
-      - README
-      - Merge
+      - '^README'
+      - '^Merge'
 
 release:
   draft: false
   prerelease: auto
-  
+
+brews:
+  - repository:
+      owner: programmersd21
+      name: homebrew-kairo
+
+    directory: Formula
+
+    commit_msg_template: "Brew formula update for {{ .ProjectName }} {{ .Tag }}"
+
+    homepage: "https://github.com/programmersd21/kairo"
+    description: "Minimal, powerful task management"
+    license: "MIT"
+
+    test: |
+      system "#{bin}/kairo", "--version"
+
+    install: |
+      bin.install "kairo"
+      

CHANGELOG.md

@@ -5,6 +5,23 @@ 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.1.5]
+
+### Added
+- **New `help` Command**: Added a comprehensive `kairo help` command to explore subcommands and their usage.
+- **Shell Tab Completions**: Added `kairo completion [bash|zsh|fish|powershell]` for full command and dynamic task ID completion.
+- **Completion Auto-Install**: Use `kairo completion <shell> install` to automatically add completion to your shell profile (Bash, Zsh, Fish).
+- **Task ID in Detail View**: Task details now display the unique task ID in the metadata section for easier API/plugin reference.
+- **Editor Shortcut Toolbar**: Added a visual footer to the New/Edit Task screen with keybind hints (`ctrl+s` save, `esc` cancel, `tab` navigate).
+- **Editor Clarity**: Added prominent "NEW TASK" and "EDIT TASK" titles to the editor card.
+- **Multi-location Config Loading**: Kairo now searches for `config.toml` in `~/.kairo/` and `~/.config/kairo/` in addition to standard platform paths.
+
+### Fixed
+- **Rainbow Toggle**: Fixed the `rainbow` configuration setting not being correctly detected and applied to the animated logo.
+
+### Changed
+- **Active Tab Styling**: The active view tab now uses the theme's accent color as a background with contrasting text for significantly better visibility.
+
 ## [1.1.4]
 
 ### Changed

CONTRIBUTING.md

@@ -46,3 +46,4 @@ This section guides you through submitting an enhancement suggestion for Kairo,
 ## Style Guide
 
 We follow the standard Go coding style. Please run `go fmt ./...` before committing.
+

README.md

@@ -68,7 +68,14 @@ Built with [Bubble Tea](https://github.com/charmbracelet/bubbletea) (TUI framewo
 
 ## 📦 Installation
 
-### Linux / macOS
+### macOS (Homebrew)
+
+```bash
+brew tap programmersd21/kairo
+brew install kairo
+```
+
+### Linux / macOS (curl)
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/programmersd21/kairo/main/scripts/install.sh | bash
@@ -84,6 +91,14 @@ iwr -useb https://raw.githubusercontent.com/programmersd21/kairo/main/scripts/in
 
 Installs to `%USERPROFILE%\\AppData\\Local\\Programs\\kairo\\kairo.exe` and adds the install directory to your user PATH.
 
+## For any OS out of these:
+
+```bash
+go install github.com/programmersd21/kairo/cmd/kairo@latest
+```
+
+**OR** use the [PREBUILTS](https://https://github.com/programmersd21/kairo/releases).
+
 ### Updates
 
 ```bash
@@ -131,6 +146,19 @@ kairo export --format markdown --out tasks.md
 # Import tasks
 kairo import --format json --in tasks.json
 
+# Shell completion (bash, zsh, fish, powershell)
+# Automatic install:
+kairo completion zsh install
+
+# Manual install (add to your shell profile):
+# source <(kairo completion zsh)
+kairo completion zsh
+
+# Get help for any command
+kairo help
+kairo help api
+kairo help export
+
 # Sync with Git (if configured)
 kairo sync
 ```
@@ -317,7 +345,7 @@ UI Re-render → Instant User Feedback
 ## 🌴 Project Structure
 
 ```
-kairo/
+.
 ├── CHANGELOG.md
 ├── cmd
 │   └── kairo
@@ -336,6 +364,8 @@ kairo/
 │   │   └── msg.go
 │   ├── buildinfo
 │   │   └── buildinfo.go
+│   ├── completion
+│   │   └── completion.go
 │   ├── config
 │   │   ├── config.go
 │   │   └── config_test.go

VERSION.txt

@@ -1 +1 @@
-1.1.4
+1.1.5

cmd/kairo/main.go

@@ -16,6 +16,7 @@ import (
 	"github.com/programmersd21/kairo/internal/api"
 	"github.com/programmersd21/kairo/internal/app"
 	"github.com/programmersd21/kairo/internal/buildinfo"
+	"github.com/programmersd21/kairo/internal/completion"
 	"github.com/programmersd21/kairo/internal/config"
 	"github.com/programmersd21/kairo/internal/core"
 	"github.com/programmersd21/kairo/internal/core/codec"
@@ -35,6 +36,41 @@ func main() {
 		return
 	}
 
+	// Immediate subcommands (no config/DB needed)
+	if len(os.Args) > 1 {
+		switch strings.ToLower(os.Args[1]) {
+		case "completion":
+			if len(os.Args) < 3 {
+				fmt.Println("Usage: kairo completion [bash|zsh|fish|powershell] [install]")
+				fmt.Println("       kairo completion --complete [args...]")
+				os.Exit(1)
+			}
+			if os.Args[2] != "--complete" {
+				shell := os.Args[2]
+				if len(os.Args) > 3 && os.Args[3] == "install" {
+					if err := completion.Install(shell); err != nil {
+						fmt.Fprintln(os.Stderr, "Error:", err)
+						os.Exit(1)
+					}
+					return
+				}
+				script, err := completion.Script(shell)
+				if err != nil {
+					fmt.Fprintln(os.Stderr, err)
+					os.Exit(1)
+				}
+				fmt.Print(script)
+				return
+			}
+		case "version":
+			runVersion()
+			return
+		case "help":
+			runHelp(os.Args[2:])
+			return
+		}
+	}
+
 	ctx, cancel := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
 	defer cancel()
 
@@ -59,12 +95,16 @@ func main() {
 	hks := hooks.New()
 	svc := service.New(repo, hks)
 
-	// Emit app start event (plugins can listen to this)
-	hks.AppStarted()
-	defer hks.AppStopped()
-
 	if len(os.Args) > 1 {
 		switch strings.ToLower(os.Args[1]) {
+		case "completion":
+			if os.Args[2] == "--complete" {
+				results := completion.Complete(ctx, svc, os.Args[3:])
+				for _, r := range results {
+					fmt.Println(r)
+				}
+				return
+			}
 		case "api":
 			if err := runAPI(ctx, svc, os.Args[2:]); err != nil {
 				fmt.Fprintln(os.Stderr, "kairo api:", err)
@@ -94,9 +134,6 @@ func main() {
 				os.Exit(2)
 			}
 			return
-		case "version":
-			runVersion()
-			return
 		case "update":
 			if err := runUpdate(ctx); err != nil {
 				fmt.Fprintln(os.Stderr, "kairo update:", err)
@@ -106,6 +143,10 @@ func main() {
 		}
 	}
 
+	// Emit app start event (plugins can listen to this)
+	hks.AppStarted()
+	defer hks.AppStopped()
+
 	m, err := app.New(ctx, cfg, svc)
 	if err != nil {
 		fmt.Fprintln(os.Stderr, "kairo:", err)
@@ -263,3 +304,52 @@ func runUpdate(ctx context.Context) error {
 		Stderr:         os.Stderr,
 	})
 }
+
+func runHelp(args []string) {
+	if len(args) == 0 {
+		fmt.Println("Kairo — Minimal, powerful task management.")
+		fmt.Println("\nUsage:")
+		fmt.Println("  kairo [command]")
+		fmt.Println("\nAvailable Commands:")
+		fmt.Println("  api         Headless API for external automation")
+		fmt.Println("  completion  Generate shell completion scripts")
+		fmt.Println("  export      Export tasks to JSON or Markdown")
+		fmt.Println("  import      Import tasks from JSON or Markdown")
+		fmt.Println("  sync        Sync tasks with Git repository")
+		fmt.Println("  update      Update Kairo to the latest version")
+		fmt.Println("  version     Show the current version")
+		fmt.Println("  help        Help about any command")
+		fmt.Println("\nUse \"kairo help [command]\" for more information about a command.")
+		return
+	}
+
+	switch args[0] {
+	case "api":
+		fmt.Println("Headless API for external automation.")
+		fmt.Println("\nUsage:")
+		fmt.Println("  kairo api [action] [flags]")
+		fmt.Println("\nActions:")
+		fmt.Println("  create, list, update, delete, get, list-tags")
+	case "completion":
+		fmt.Println("Generate shell completion scripts.")
+		fmt.Println("\nUsage:")
+		fmt.Println("  kairo completion [bash|zsh|fish|powershell] [install]")
+		fmt.Println("  kairo completion --complete [args...]")
+		fmt.Println("\nExample:")
+		fmt.Println("  kairo completion zsh install")
+	case "export":
+		fmt.Println("Export tasks to JSON or Markdown.")
+		fmt.Println("\nUsage:")
+		fmt.Println("  kairo export --format [json|md] --out [file]")
+	case "import":
+		fmt.Println("Import tasks from JSON or Markdown.")
+		fmt.Println("\nUsage:")
+		fmt.Println("  kairo import --format [json|md] --in [file]")
+	case "sync":
+		fmt.Println("Sync tasks with Git repository.")
+		fmt.Println("\nUsage:")
+		fmt.Println("  kairo sync")
+	default:
+		fmt.Printf("Unknown help topic %q\n", args[0])
+	}
+}

configs/kairo.example.toml

@@ -2,6 +2,7 @@
 theme = "catppuccin"
 vim_mode = false
 show_help = true
+rainbow = false
 
 [theme]
 # Any field set here overrides the built-in theme colors.