feat: aesthetic icons and multi-theme support (unicode, nerdfont, octicons)

Author: codevalve

ROADMAP.md

@@ -1,74 +1,33 @@
-# Rapide Roadmap
-
-This document outlines the planned trajectory for Rapide beyond the initial local CLI release.
-
-## v2.0.0: Interactive TUI (Released 🗿🚀)
-The goal is to transition Rapide from a purely command-driven tool to an interactive experience for reviewing and managing logs.
-
-- **Infrastructure**: Implement a Terminal User Interface (TUI) using [Charm Bubble Tea](https://github.com/charmbracelet/bubbletea) and [Charm Lipgloss](https://github.com/charmbracelet/lipgloss).
-- **Features**:
-  - **Interactive List View**: Scroll through entries, filter in real-time, and toggle "Done" states with hotkeys.
-  - **Editor Integration**: Open entries in an interactive multi-line editor for faster journaling.
-  - **Visual Board**: A "Dash" view showing a high-level summary of your collections and pending tasks.
-
-## v2.5.0: Git Sync (Bridge) (Released 🌉🚀)
-Bridging the gap between local-only and cloud-hosted logs by leveraging private Git repositories.
-
-- **Infrastructure**: Lightweight Git automation for the `~/.rapide/` directory.
-- **Features**:
-  - **Single Command Sync**: `rapide sync` to pull, merge (rebase), and push logs to a configured remote.
-  - **Optional Autosync**: Configurable setting to automatically sync on every write or TUI exit.
-  - **Setup Wizard**: `rapide sync --setup` to easily link a private repository.
-
-## v2.6.0: Pinning (Released 📌🚀)
-- **Features**:
-  - **Pinning**: `rapide pin <id>` to keep critical entries or current projects at the top of the list.
-
-## v2.6.1: Polish & Organization (Released 🛠️🚀)
-- **Features**:
-  - **TUI Config Editor**: `c` hotkey to manage Git URL and Autosync directly in the UI.
-  - **Clipboard Support**: Robust handling for multi-character pastes in the terminal.
-  - **Dynamic Layout**: Constrained collection column width with automatic truncation.
-
-## v2.7.2: Security Fix (Released 🔒🚀)
-- **Fixes**:
-  - **esbuild**: Resolved a security vulnerability in `esbuild` using npm overrides in the documentation site.
-
-## v2.7.1: Build & Security (Released 🛠️🚀)
-- **Fixes**:
-  - **CI/CD Align**: Updated Go to 1.25 and Node to 22 in GitHub Actions.
-  - **Security**: Added Dependabot configuration for automated dependency tracking.
-
-## v2.7.0: Documentation & Onboarding (Released 📖🚀)
-The goal is to lower the barrier to entry and ensure Rapide feels accessible to new users while maintaining its professional edge.
-
-- **Infrastructure**: Refined internal documentation and self-documenting CLI help.
-- **Features**:
-  - **`rapide init`**: Interactive setup wizard to seed your journal.
-  - **TUI Help Overlay**: In-app quick reference (press `?`).
-  - **VitePress Documentation**: Dedicated docs site on GitHub Pages.
-
-## v3.0.0: Rapide MCP (Model Context Protocol) (Released 🗿🚀)
-Bridging the gap between your logs and AI agents by making Rapide a first-class MCP server via a hidden `mcp start` command.
-
-- **Infrastructure**: Implement a Model Context Protocol (MCP) server within the binary.
-- **Features**:
-  - **Contextual Search**: Allow AI agents to search and retrieve relevant journal entries to inform their tasks.
-  - **Automated Logging**: Enable agents to "log a thought" or "record a milestone" directly into Rapide.
-  - **Tool Integration**: Expose `rapide` commands (list, done, migrate) as MCP tools.
-  - **Privacy First**: Local-first MCP server ensuring your journal stays under your control.
-
-## v3.0.2: CI/CD Maintenance (Released 🛠️🚀)
-Maintenance release focusing on fixing build warnings and keeping CI/CD healthy.
-- **Infrastructure**:
-  - Update GoReleaser configuration to use specified version (`~> v2`).
-  - Opt actions runner into Node.js 24 runtime to future-proof workflows.
-
-## v3.0.3: GoReleaser Deprecation Fix (Released 🛠️🚀)
-- **Infrastructure**:
-  - Address GoReleaser v2 deprecations by renaming `format` to `formats` in `.goreleaser.yaml`.
-
-
----
-
-*Inspired by the philosophy of Rapid Logging and the aesthetics of the Charm toolchain.*
+# Rapide Roadmap 🗿🚀
+
+## v1.0: Core Foundation (Completed)
+- [x] Basic rapid logging (tasks, notes, events).
+- [x] JSONL storage backbone.
+- [x] Primitive CLI list/add.
+
+## v2.0: TUI & Refinement (Completed)
+- [x] Full interactive TUI with `bubbletea`.
+- [x] Real-time filtering and status bars.
+- [x] The `./dev` wrapper for isolated development.
+
+## v2.5: Power User Features (Current)
+- [x] **Pinning**: Keep important items at the top (`p` in TUI).
+- [x] **Priority**: Visual highlighting for urgent tasks (`!` suffix).
+- [x] **Edit Mode**: Quick entry correction (`e` in TUI).
+- [x] **Archive/Trim**: Keep the journal lean by moving old items.
+
+## v3.0: MCP & Agentic Workflows (Planned)
+- [x] **MCP Server**: Expose Rapide tools to local AI agents (Antigravity).
+- [x] **Agent Discovery**: Allow agents to read and search private logs securely.
+- [x] **Sync Bridge**: Robust Git synchronization for multi-device workflows.
+
+## v3.1.0: Frictionless Time Logging (Completed ◔🚀)
+- [x] **Numpad Trigger**: Implicitly open time entry mode by typing numbers in the TUI.
+- [x] **Auto-Formatting**: Smart `HH:MM` input with real-time validation.
+- [x] **Origin Indicators**: Visual distinction between user-created (◔) and agent-created (◇) time entries.
+- [x] **Aesthetic Icons**: Replaced clunky emojis with refined Unicode symbols (◆, ◔, ◇).
+
+## v4.0: Beyond the Binary (Future)
+- [ ] **Plugins**: WASM-based extensions for custom bullets or export formats.
+- [ ] **Dashboards**: A summary view of weekly velocity and open tasks.
+- [ ] **Mobile Companion**: Lightweight helper app for logging on the go.

cmd/list.go

@@ -5,6 +5,7 @@ import (
 	"os"
 	"rapide/internal/model"
 	"rapide/internal/storage"
+	"rapide/internal/tui"
 	"sort"
 	"strings"
 	"time"
@@ -115,8 +116,9 @@ var listCmd = &cobra.Command{
 			}
 
 			filtered = append(filtered, e)
-			if len(e.MarginKey) > maxMargin {
-				maxMargin = len(e.MarginKey)
+			mk := tui.StripIcons(e.MarginKey)
+			if len(mk) > maxMargin {
+				maxMargin = len(mk)
 			}
 		}
 

cmd/root.go

@@ -5,12 +5,30 @@ import (
 	"os"
 	"rapide/internal"
 	"rapide/internal/storage"
+	"rapide/internal/tui"
 
 	"github.com/charmbracelet/lipgloss"
 	"github.com/spf13/cobra"
 )
 
-var Version = "3.0.3"
+func init() {
+	rootCmd.PersistentPreRun = func(cmd *cobra.Command, args []string) {
+		cfg, _ := storage.LoadConfig()
+		if cfg != nil {
+			theme := cfg.IconTheme
+			// Migration path for legacy nerd_fonts boolean
+			if theme == "" && cfg.NerdFonts {
+				theme = "nerdfont"
+			}
+			if theme == "" {
+				theme = "unicode"
+			}
+			tui.SetIconTheme(theme)
+		}
+	}
+}
+
+var Version = "3.1.0"
 
 var successStyle = lipgloss.NewStyle().
 	Bold(true).

cmd/ui.go

@@ -3,66 +3,91 @@ package cmd
 import (
 	"fmt"
 	"rapide/internal/model"
+	"rapide/internal/tui"
+	"strings"
 
 	"github.com/charmbracelet/lipgloss"
 )
 
 var (
-	timestampStyle = lipgloss.NewStyle().Foreground(lipgloss.Color("#757575"))
-	marginStyle    = lipgloss.NewStyle().Foreground(lipgloss.Color("#00ADD8")).Bold(true)
+	timestampStyle = lipgloss.NewStyle().Foreground(lipgloss.Color("8")).Faint(true) // SecondaryColor
+	marginStyle    = lipgloss.NewStyle().Foreground(lipgloss.Color("6")).Bold(true) // PrimaryColor
 	bulletStyle    = lipgloss.NewStyle().Bold(true)
-	priorityStyle  = lipgloss.NewStyle().Foreground(lipgloss.Color("#FF0000")).Bold(true)
+	priorityStyle  = lipgloss.NewStyle().Foreground(lipgloss.Color("208")).Bold(true) // AccentColor
 	noteStyle      = lipgloss.NewStyle().Foreground(lipgloss.Color("#EEEEEE"))
-	idStyle        = lipgloss.NewStyle().Foreground(lipgloss.Color("#555555")).Italic(true).Width(5)
-	doneStyle      = lipgloss.NewStyle().Foreground(lipgloss.Color("#444444")).Strikethrough(true)
-	pinnedStyle    = lipgloss.NewStyle().Foreground(lipgloss.Color("#00FF00")).Bold(true)
+	idStyle        = lipgloss.NewStyle().Foreground(lipgloss.Color("8")).Faint(true) // DimmedIDStyle
+	doneStyle      = lipgloss.NewStyle().Foreground(lipgloss.Color("8")).Strikethrough(true)
+	pinnedStyle    = lipgloss.NewStyle().Foreground(lipgloss.Color("3")).Bold(true) // HighlightColor
 )
 
 func renderEntry(e model.Entry, marginWidth int) {
 	if marginWidth < 2 {
 		marginWidth = 2
 	}
+	if marginWidth > 12 {
+		marginWidth = 12
+	}
+
+	// TUI Format: [ID] 02 Jan 15:04 📌 MarginKey Bullet Content
+	rawTS := e.Timestamp.Format("02 Jan 15:04")
+	// Indicator column (Pin > Time > Agent)
+	icon := tui.GetIcon(e.Pinned, e.MarginKey)
+	if icon == "" {
+		icon = " "
+	}
+	indicatorStr := pinnedStyle.Render(icon)
 
-	rawTS := e.Timestamp.Format("2006-01-02 15:04")
-	rawMK := fmt.Sprintf("%-*s", marginWidth, e.MarginKey)
+	displayMK := tui.StripIcons(e.MarginKey)
+	if len(displayMK) > marginWidth {
+		displayMK = displayMK[:marginWidth-1] + "…"
+	}
+	rawMK := fmt.Sprintf("%-*s", marginWidth, displayMK)
 	rawBlt := e.Bullet
 	rawCnt := e.Content
-	rawID := e.ID
+	rawID := fmt.Sprintf("[%s]", e.ID)
 	rawPrio := ""
 	if e.Priority {
 		rawPrio = "!"
 	}
 
-	// If done, overwrite components with dimmed style
-	if e.Bullet == "x" {
-		ts := doneStyle.Render(rawTS)
-		mk := doneStyle.Render(rawMK)
-		blt := doneStyle.Render(rawBlt)
-		cnt := doneStyle.Render(rawCnt)
-		id := doneStyle.Render(fmt.Sprintf("%-5s", rawID))
-		prio := doneStyle.Render(rawPrio)
-		pn := "  "
-		if e.Pinned {
-			pn = doneStyle.Render("📌")
-		}
-		fmt.Printf("%s | %s | %s | %s %s %s %s\n", id, ts, mk, pn, blt, cnt, prio)
-		return
-	}
-
-	// Default styling
+	// Default colors/styles
 	ts := timestampStyle.Render(rawTS)
-	mk := marginStyle.Render(rawMK)
-	blt := bulletStyle.Render(rawBlt)
+	mk := "  "
+	if displayMK != "" {
+		mk = marginStyle.Render(rawMK)
+	} else {
+		mk = strings.Repeat(" ", marginWidth)
+	}
+	bltStyle := bulletStyle
+	switch e.Bullet {
+	case "•":
+		bltStyle = bltStyle.Foreground(lipgloss.Color("#FFFFFF"))
+	case "O":
+		bltStyle = bltStyle.Foreground(lipgloss.Color("#AFEEEE"))
+	case "-", "—":
+		bltStyle = bltStyle.Foreground(lipgloss.Color("#C0C0C0"))
+	case ">":
+		bltStyle = bltStyle.Foreground(lipgloss.Color("#D3D3D3"))
+	}
+	blt := bltStyle.Render(rawBlt)
 	cnt := noteStyle.Render(rawCnt)
-	id := idStyle.Render(rawID)
+	id := idStyle.Render(fmt.Sprintf("%-6s", rawID))
 	prio := ""
 	if e.Priority {
 		prio = priorityStyle.Render(rawPrio)
 	}
-	pn := "  "
-	if e.Pinned {
-		pn = pinnedStyle.Render("📌")
+
+	if e.Bullet == "x" {
+		ts = doneStyle.Render(rawTS)
+		mk = doneStyle.Render(rawMK)
+		blt = doneStyle.Render("x")
+		cnt = doneStyle.Render(rawCnt)
+		id = doneStyle.Render(fmt.Sprintf("%-6s", rawID))
+		prio = doneStyle.Render(rawPrio)
+		if e.Pinned {
+			indicatorStr = doneStyle.Render("📌")
+		}
 	}
 
-	fmt.Printf("%s | %s | %s | %s %s %s %s\n", id, ts, mk, pn, blt, cnt, prio)
+	fmt.Printf("%s %s %s %s %s %s%s\n", id, ts, indicatorStr, mk, blt, cnt, prio)
 }

demo/config.json

@@ -1,4 +1,5 @@
 {
-  "remote_url": "git@github.com:user/journal.git",
-  "auto_sync": false
+  "auto_sync": false,
+  "auto_hide_days": 14,
+  "icon_theme": "nerdfont"
 }

internal/mcp/adapter.go

@@ -4,6 +4,7 @@ import (
 	"context"
 	"rapide/internal/model"
 	"rapide/internal/storage"
+	"rapide/internal/tui"
 	"strings"
 	"time"
 )
@@ -32,6 +33,23 @@ func (a *storageAdapter) AddAgentEntry(ctx context.Context, content string) (*mo
 		Pinned:    false,
 	}
 
+	// Detect if content starts with HH:MM | or just HH:MM
+	parts := strings.SplitN(content, " ", 2)
+	potentialTime := strings.TrimSuffix(parts[0], "|")
+	if len(potentialTime) == 5 && potentialTime[2] == ':' {
+		hh := potentialTime[:2]
+		mm := potentialTime[3:]
+		// Simple validation
+		if hh >= "00" && hh <= "23" && mm >= "00" && mm <= "59" {
+			entry.MarginKey = tui.PrefixAgent + potentialTime
+			if len(parts) > 1 {
+				entry.Content = strings.TrimPrefix(parts[1], "| ")
+			} else {
+				entry.Content = ""
+			}
+		}
+	}
+
 	id, err := a.storage.Append(entry)
 	if err != nil {
 		return nil, err
@@ -49,7 +67,8 @@ func (a *storageAdapter) SearchAgentEntries(ctx context.Context, query string) (
 	var results []model.Entry
 	q := strings.ToLower(query)
 	for _, e := range all {
-		if e.MarginKey == "AGENT" && strings.Contains(strings.ToLower(e.Content), q) {
+		isAgent := e.MarginKey == "AGENT" || strings.HasPrefix(e.MarginKey, tui.IconAgent) || strings.HasPrefix(e.MarginKey, "🤖")
+		if isAgent && strings.Contains(strings.ToLower(e.Content), q) {
 			results = append(results, e)
 		}
 	}
@@ -64,7 +83,8 @@ func (a *storageAdapter) ListRecentAgentEntries(ctx context.Context, limit int)
 
 	var agentEntries []model.Entry
 	for i := len(all) - 1; i >= 0; i-- {
-		if all[i].MarginKey == "AGENT" {
+		isAgent := all[i].MarginKey == "AGENT" || strings.HasPrefix(all[i].MarginKey, tui.IconAgent) || strings.HasPrefix(all[i].MarginKey, "🤖")
+		if isAgent {
 			agentEntries = append(agentEntries, all[i])
 			if len(agentEntries) >= limit {
 				break