feat: TUI polish, first-run setup, hardening

Theme system with dark/light switching, syntax highlighting for code
blocks, auto-scroll that respects manual scrolling, slash commands
(/help, /clear, /copy, /theme, /model, /session, /compact, /quit),
contextual key hints, tool progress counter, and notification viewport
fix.

Hardening: transient HTTP retry with backoff, tool call ID matching
for parallel tools, symlink-safe path resolution, file permission
preservation, process group kill for shell timeouts, binary file
detection, subagent shell sandboxing, ANSI-safe string truncation,
streaming viewport debounce, and dangerous command blocklist.

First-run experience: prompts for API key interactively when
OPENAI_API_KEY is not set, saves to ~/.codebase/config.json.
Session restore is now opt-in via --resume flag.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: halfaipg

.env.example

@@ -0,0 +1,25 @@
+# ── Required ─────────────────────────────────────────────────
+OPENAI_API_KEY=sk-...              # Any OpenAI-compatible API key
+
+# ── Optional: LLM Provider ──────────────────────────────────
+# OPENAI_BASE_URL=https://api.openai.com/v1   # Default; change for other providers
+# OPENAI_MODEL=gpt-4o                          # Default model
+
+# ── Optional: Glue Sidecar (intent routing, narration) ──────
+# Falls back to OPENAI_* values if not set. Point at a fast/cheap
+# model (Groq, local ollama, etc.) to keep agent costs separate.
+# GLUE_API_KEY=gsk_...
+# GLUE_BASE_URL=https://api.groq.com/openai/v1
+# GLUE_SMART_MODEL=openai/gpt-oss-20b         # Intent classification, planning
+# GLUE_FAST_MODEL=llama-3.1-8b-instant        # Narration, titles, celebrations
+
+# ── Optional: Web Search ────────────────────────────────────
+# Auto-detects from available keys. Falls back to DuckDuckGo (no key needed).
+# SEARCH_PROVIDER=tavily                       # tavily, brave, searxng, or duckduckgo
+# TAVILY_API_KEY=tvly-...
+# BRAVE_API_KEY=BSA...
+# SEARXNG_URL=http://localhost:8080            # Self-hosted SearXNG instance
+
+# ── Optional: UI ─────────────────────────────────────────────
+# CODEBASE_THEME=dark                          # dark (default) or light
+# CODEBASE_NOBOOT=1                            # Skip the boot animation

agent.go

@@ -7,6 +7,7 @@ import (
 	"path/filepath"
 	"strings"
 	"sync"
+	"time"
 )
 
 // ──────────────────────────────────────────────────────────────
@@ -34,6 +35,7 @@ type AgentEvent struct {
 	Type    EventType
 	Text    string         // EventTextDelta
 	Tool    string         // EventToolStart / EventToolResult — tool name
+	ToolID  string         // EventToolStart / EventToolResult — tool call ID
 	Args    map[string]any // EventToolStart — parsed arguments
 	Output  string         // EventToolResult — tool output
 	Success bool           // EventToolResult
@@ -101,7 +103,8 @@ func strPtr(s string) *string { return &s }
 func buildSystemPrompt(workDir string) string {
 	var sb strings.Builder
 	sb.WriteString(systemPrompt)
-	sb.WriteString(fmt.Sprintf("\n\nWorking directory: %s\n", workDir))
+	sb.WriteString(fmt.Sprintf("\n\nCurrent date: %s\n", time.Now().Format("2006-01-02")))
+	sb.WriteString(fmt.Sprintf("Working directory: %s\n", workDir))
 
 	// Load project instructions if available
 	projectInstructions := loadProjectInstructions(workDir)
@@ -267,7 +270,7 @@ func (a *Agent) Run(prompt string) {
 				}
 
 			case StreamError:
-				a.events <- AgentEvent{Type: EventError, Error: evt.Error}
+				a.events <- AgentEvent{Type: EventError, Error: fmt.Errorf("%s", humanizeError(evt.Error))}
 				a.events <- AgentEvent{Type: EventDone, Text: "Error occurred."}
 				return
 
@@ -310,7 +313,7 @@ func (a *Agent) Run(prompt string) {
 		// Loop back for next turn
 	}
 
-	a.events <- AgentEvent{Type: EventDone, Text: "Reached maximum turns."}
+	a.events <- AgentEvent{Type: EventDone, Text: fmt.Sprintf("Reached maximum turns (%d). You can continue with a follow-up prompt.", maxTurns)}
 }
 
 // executeToolCalls runs tool calls with parallel execution for read-only tools.
@@ -341,12 +344,15 @@ func (a *Agent) executeToolCalls(toolCalls []ToolCall, consecutiveErrors *int) {
 
 		for i, tc := range parallel {
 			var argsMap map[string]any
-			json.Unmarshal([]byte(tc.Function.Arguments), &argsMap)
+			if err := json.Unmarshal([]byte(tc.Function.Arguments), &argsMap); err != nil {
+				argsMap = map[string]any{"_raw": tc.Function.Arguments}
+			}
 
 			a.events <- AgentEvent{
-				Type: EventToolStart,
-				Tool: tc.Function.Name,
-				Args: argsMap,
+				Type:   EventToolStart,
+				Tool:   tc.Function.Name,
+				ToolID: tc.ID,
+				Args:   argsMap,
 			}
 
 			wg.Add(1)
@@ -384,6 +390,7 @@ func (a *Agent) executeToolCalls(toolCalls []ToolCall, consecutiveErrors *int) {
 			a.events <- AgentEvent{
 				Type:    EventToolResult,
 				Tool:    r.tc.Function.Name,
+				ToolID:  r.tc.ID,
 				Args:    r.args,
 				Output:  r.output,
 				Success: r.success,
@@ -401,12 +408,15 @@ func (a *Agent) executeToolCalls(toolCalls []ToolCall, consecutiveErrors *int) {
 	// Run mutating tools sequentially
 	for _, tc := range sequential {
 		var argsMap map[string]any
-		json.Unmarshal([]byte(tc.Function.Arguments), &argsMap)
+		if err := json.Unmarshal([]byte(tc.Function.Arguments), &argsMap); err != nil {
+			argsMap = map[string]any{"_raw": tc.Function.Arguments}
+		}
 
 		a.events <- AgentEvent{
-			Type: EventToolStart,
-			Tool: tc.Function.Name,
-			Args: argsMap,
+			Type:   EventToolStart,
+			Tool:   tc.Function.Name,
+			ToolID: tc.ID,
+			Args:   argsMap,
 		}
 
 		var output string
@@ -438,6 +448,7 @@ func (a *Agent) executeToolCalls(toolCalls []ToolCall, consecutiveErrors *int) {
 		a.events <- AgentEvent{
 			Type:    EventToolResult,
 			Tool:    tc.Function.Name,
+			ToolID:  tc.ID,
 			Args:    argsMap,
 			Output:  output,
 			Success: success,

app.go

@@ -1,6 +1,8 @@
 package main
 
 import (
+	"os"
+
 	tea "github.com/charmbracelet/bubbletea"
 )
 
@@ -23,15 +25,22 @@ type appModel struct {
 }
 
 func newAppModel(cfg *Config) appModel {
+	startScreen := screenBoot
+	if os.Getenv("CODEBASE_NOBOOT") != "" {
+		startScreen = screenChat
+	}
 	return appModel{
-		screen: screenBoot,
+		screen: startScreen,
 		boot:   newBootModel(cfg),
 		chat:   newChatModel(cfg),
 		config: cfg,
 	}
 }
 
 func (m appModel) Init() tea.Cmd {
+	if m.screen == screenChat {
+		return m.chat.Init()
+	}
 	return m.boot.Init()
 }
 

boot.go

@@ -9,7 +9,6 @@ import (
 	"time"
 
 	tea "github.com/charmbracelet/bubbletea"
-	"github.com/charmbracelet/lipgloss"
 )
 
 // ──────────────────────────────────────────────────────────────
@@ -866,5 +865,3 @@ func iabs(x int) int {
 	}
 	return x
 }
-
-var _ = lipgloss.NewStyle