feat: implement self-updating mechanism and installation scripts

Introduce a robust self-update system via GitHub Releases, add cross-platform
installation scripts, and improve build metadata injection.

- Implement `kairo update` command to download, verify, and swap binaries
- Add `scripts/install.sh` and `scripts/install.ps1` for easy setup
- Refactor build metadata injection using `internal/buildinfo` via GoReleaser
- Update plugin menu to display keybinding legends
- Update versioning and documentation to reflect 1.1.3 release

Author: programmersd21

.goreleaser.yaml

@@ -28,11 +28,11 @@ builds:
 
     mod_timestamp: "{{ .CommitTimestamp }}"
 
-    ldflags:
-      - -s -w
-      - -X main.version={{ .Version }}
-      - -X main.commit={{ .ShortCommit }}
-      - -X main.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
@@ -73,4 +73,4 @@ changelog:
 release:
   draft: false
   prerelease: auto
-  
+  

CHANGELOG.md

@@ -3,12 +3,26 @@
 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.2]
-
-### Added
-- **Plugin Metadata Display**: Press `Enter` on a plugin in the menu to view full metadata including Name, Description, Author, and Version.
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.3]
+
+### Added
+- **Self-updating binary updater**: `kairo update` now downloads the correct GitHub Release asset for your OS/arch, verifies it against `checksums.txt`, and performs a safe in-place binary swap (with `.old` backup/rollback).
+- **Cross-platform install scripts**: `scripts/install.sh` (Linux/macOS) and `scripts/install.ps1` (Windows) install into standard user locations and add the install directory to PATH when possible.
+- **Plugin menu keybind footer**: plugin manager overlay now shows a quick keybind legend (`enter`, `u`, `esc`, etc.).
+
+### Changed
+- `kairo version` now prints build version + commit (when available).
+- GoReleaser now injects build metadata into `internal/buildinfo` (instead of `main.*`).
+
+### Removed
+- `go install`-based updater flow (replaced by the GitHub Releases updater).
+
+## [1.1.2]
+
+### Added
+- **Plugin Metadata Display**: Press `Enter` on a plugin in the menu to view full metadata including Name, Description, Author, and Version.
 - **Uninstall Confirmation**: Added safety confirmation dialog before uninstalling plugins with `u` key.
 
 ## [1.1.1]

README.md

@@ -54,6 +54,35 @@ Built with [Bubble Tea](https://github.com/charmbracelet/bubbletea) (TUI framewo
 
 ---
 
+## 📦 Installation
+
+### Linux / macOS
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/programmersd21/kairo/main/scripts/install.sh | bash
+```
+
+Installs to `$HOME/.local/bin/kairo` (fallback: `/usr/local/bin/kairo`) and attempts to persist the PATH update in your shell profile when needed.
+
+### Windows (PowerShell)
+
+```powershell
+iwr -useb https://raw.githubusercontent.com/programmersd21/kairo/main/scripts/install.ps1 | iex
+```
+
+Installs to `%USERPROFILE%\\AppData\\Local\\Programs\\kairo\\kairo.exe` and adds the install directory to your user PATH.
+
+### Updates
+
+```bash
+kairo update
+```
+
+Downloads the latest GitHub Release for your OS/arch, verifies it against `checksums.txt`, and safely replaces the installed binary.
+On Windows, the update is applied after `kairo update` exits; run `kairo` again once it completes.
+
+---
+
 ## 🤖 Automation & CLI API
 
 Kairo provides a stable CLI API for external automation. Every operation available in the TUI can be performed via the `api` subcommand.
@@ -293,6 +322,8 @@ kairo/
 │   ├── app
 │   │   ├── model.go
 │   │   └── msg.go
+│   ├── buildinfo
+│   │   └── buildinfo.go
 │   ├── config
 │   │   ├── config.go
 │   │   └── config_test.go
@@ -350,6 +381,13 @@ kairo/
 │   │   │   └── theme.go
 │   │   └── theme_menu
 │   │       └── model.go
+│   ├── updater
+│   │   ├── checksums.go
+│   │   ├── download.go
+│   │   ├── extract.go
+│   │   ├── github.go
+│   │   ├── updater.go
+│   │   └── windows_helper.go
 │   └── util
 │       ├── paths.go
 │       └── util_test.go
@@ -363,6 +401,9 @@ kairo/
 ├── README.md
 ├── screenshots
 │   └── thumbnail.png
+├── scripts
+│   ├── install.ps1
+│   └── install.sh
 ├── SECURITY.md
 └── VERSION.txt
 ```

VERSION.txt

@@ -1 +1 @@
-1.1.2
+1.1.3

cmd/kairo/main.go

@@ -5,10 +5,7 @@ import (
 	"encoding/json"
 	"errors"
 	"fmt"
-	"io"
-	"net/http"
 	"os"
-	"os/exec"
 	"os/signal"
 	"path/filepath"
 	"strings"
@@ -18,16 +15,26 @@ import (
 
 	"github.com/programmersd21/kairo/internal/api"
 	"github.com/programmersd21/kairo/internal/app"
+	"github.com/programmersd21/kairo/internal/buildinfo"
 	"github.com/programmersd21/kairo/internal/config"
 	"github.com/programmersd21/kairo/internal/core"
 	"github.com/programmersd21/kairo/internal/core/codec"
 	"github.com/programmersd21/kairo/internal/hooks"
 	"github.com/programmersd21/kairo/internal/service"
 	"github.com/programmersd21/kairo/internal/storage"
 	ksync "github.com/programmersd21/kairo/internal/sync"
+	"github.com/programmersd21/kairo/internal/updater"
 )
 
 func main() {
+	if handled, err := updater.MaybeRunWindowsApply(os.Stdout, os.Stderr); handled {
+		if err != nil {
+			fmt.Fprintln(os.Stderr, "kairo update:", err)
+			os.Exit(2)
+		}
+		return
+	}
+
 	ctx, cancel := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
 	defer cancel()
 
@@ -245,144 +252,14 @@ func runImport(ctx context.Context, repo *storage.Repository, args []string) err
 }
 
 func runVersion() {
-	version := getCurrentVersion()
-	fmt.Printf("kairo version %s\n", version)
-}
-
-func getCurrentVersion() string {
-	// Try current working directory first (most common for development/running)
-	if data, err := os.ReadFile("VERSION.txt"); err == nil {
-		return strings.TrimSpace(string(data))
-	}
-
-	// Try repository root relative to binary location
-	if ex, err := os.Executable(); err == nil {
-		versionPath := filepath.Join(filepath.Dir(ex), "VERSION.txt")
-		if data, err := os.ReadFile(versionPath); err == nil {
-			return strings.TrimSpace(string(data))
-		}
-
-		// Try going up from the binary directory (for development builds)
-		versionPath = filepath.Join(filepath.Dir(ex), "..", "VERSION.txt")
-		if data, err := os.ReadFile(versionPath); err == nil {
-			return strings.TrimSpace(string(data))
-		}
-	}
-
-	// If not found in expected locations, try home config directory
-	homeDir, _ := os.UserHomeDir()
-	altPath := filepath.Join(homeDir, ".config", "kairo", "VERSION.txt")
-	if data, err := os.ReadFile(altPath); err == nil {
-		return strings.TrimSpace(string(data))
-	}
-
-	// Fallback to default
-	return "1.1.2"
-}
-
-type GitHubRelease struct {
-	TagName    string `json:"tag_name"`
-	Draft      bool   `json:"draft"`
-	Prerelease bool   `json:"prerelease"`
-}
-
-func getLatestGitHubRelease(ctx context.Context) (string, error) {
-	// Query GitHub API for the latest release
-	url := "https://api.github.com/repos/programmersd21/kairo/releases/latest"
-	req, err := http.NewRequestWithContext(ctx, "GET", url, nil)
-	if err != nil {
-		return "", err
-	}
-
-	req.Header.Set("Accept", "application/vnd.github.v3+json")
-
-	client := &http.Client{}
-	resp, err := client.Do(req)
-	if err != nil {
-		return "", err
-	}
-	defer func() {
-		_ = resp.Body.Close()
-	}()
-
-	if resp.StatusCode != http.StatusOK {
-		return "", fmt.Errorf("GitHub API returned status %d", resp.StatusCode)
-	}
-
-	body, err := io.ReadAll(resp.Body)
-	if err != nil {
-		return "", err
-	}
-
-	var release GitHubRelease
-	if err := json.Unmarshal(body, &release); err != nil {
-		return "", err
-	}
-
-	// Remove 'v' prefix if present
-	version := strings.TrimPrefix(release.TagName, "v")
-	return version, nil
-}
-
-func compareVersions(current, latest string) int {
-	// Parse semantic versions: x.y.z
-	currentParts := strings.Split(strings.TrimPrefix(current, "v"), ".")
-	latestParts := strings.Split(strings.TrimPrefix(latest, "v"), ".")
-
-	// Pad with zeros if needed
-	for len(currentParts) < 3 {
-		currentParts = append(currentParts, "0")
-	}
-	for len(latestParts) < 3 {
-		latestParts = append(latestParts, "0")
-	}
-
-	// Simple numeric comparison
-	for i := 0; i < 3; i++ {
-		var curr, last int
-		_, _ = fmt.Sscanf(currentParts[i], "%d", &curr)
-		_, _ = fmt.Sscanf(latestParts[i], "%d", &last)
-
-		if last > curr {
-			return -1 // latest is newer
-		}
-		if last < curr {
-			return 1 // current is newer
-		}
-	}
-	return 0 // equal
+	fmt.Printf("kairo %s\n", buildinfo.VersionWithCommit())
 }
 
 func runUpdate(ctx context.Context) error {
-	currentVersion := getCurrentVersion()
-	fmt.Printf("Checking for updates (current: %s)...\n", currentVersion)
-
-	latestVersion, err := getLatestGitHubRelease(ctx)
-	if err != nil {
-		return fmt.Errorf("failed to fetch latest release: %w", err)
-	}
-
-	cmp := compareVersions(currentVersion, latestVersion)
-	if cmp >= 0 {
-		// Already on latest or newer version
-		fmt.Printf("✓ Updated to latest version %s\n", currentVersion)
-		return nil
-	}
-
-	// There's a newer version available
-	fmt.Printf("Found newer version: %s\n", latestVersion)
-	fmt.Println("Updating kairo...")
-
-	// Execute: go install github.com/programmersd21/kairo/cmd/kairo@latest
-	cmd := exec.CommandContext(ctx, "go", "install", "github.com/programmersd21/kairo/cmd/kairo@latest")
-	cmd.Stdout = os.Stdout
-	cmd.Stderr = os.Stderr
-	cmd.Stdin = os.Stdin
-
-	if err := cmd.Run(); err != nil {
-		return fmt.Errorf("failed to update: %w", err)
-	}
-
-	fmt.Printf("✓ Kairo updated to version %s successfully!\n", latestVersion)
-	return nil
+	cfg := updater.DefaultConfig()
+	return cfg.Update(ctx, updater.UpdateOptions{
+		CurrentVersion: buildinfo.EffectiveVersion(),
+		Stdout:         os.Stdout,
+		Stderr:         os.Stderr,
+	})
 }

go.mod

@@ -15,7 +15,9 @@ require (
 )
 
 require (
+	aead.dev/minisign v0.2.0 // indirect
 	github.com/AlekSi/pointer v1.0.0 // indirect
+	github.com/Masterminds/semver/v3 v3.4.0 // indirect
 	github.com/alecthomas/chroma/v2 v2.14.0 // indirect
 	github.com/atotto/clipboard v0.1.4 // indirect
 	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
@@ -35,6 +37,7 @@ require (
 	github.com/mattn/go-localereader v0.0.1 // indirect
 	github.com/mattn/go-runewidth v0.0.16 // indirect
 	github.com/microcosm-cc/bluemonday v1.0.27 // indirect
+	github.com/minio/selfupdate v0.6.0 // indirect
 	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
 	github.com/muesli/cancelreader v0.2.2 // indirect
 	github.com/muesli/reflow v0.3.0 // indirect
@@ -46,6 +49,7 @@ require (
 	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
 	github.com/yuin/goldmark v1.7.8 // indirect
 	github.com/yuin/goldmark-emoji v1.0.5 // indirect
+	golang.org/x/crypto v0.31.0 // indirect
 	golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b // indirect
 	golang.org/x/net v0.33.0 // indirect
 	golang.org/x/sync v0.15.0 // indirect