fix(scripts): Add cli mode

Author: pergatore

README.md

@@ -10,11 +10,12 @@ A beautiful terminal-based time tracker built with Go and the Charmbracelet ecos
 
 - 🎯 **Retrospective time tracking** - Log completed tasks with automatic duration calculation
 - 🎨 **Beautiful TUI interface** - Styled with Charmbracelet's Lipgloss
-- ⚡ **Simple workflow** - Start → Work → Complete tasks → View reports
+- ⚡ **CLI and TUI modes** - Quick command-line operations or interactive interface
 - 📊 **Real-time summaries** - Work/break/total time with project breakdowns
 - 🔄 **Task extension** - Extend the last task if you're still working on it
 - 💾 **Persistent storage** - JSON-based data storage with automatic backups
 - 🎨 **Color-coded activities** - Visual distinction between work, breaks, and ignored time
+- 📋 **Project categorization** - Automatic parsing of "Project: Task" format
 
 ## 🚀 Installation
 
@@ -48,7 +49,40 @@ go install
 
 ## 🎮 Usage
 
-### Key Commands
+### Command Line Interface (CLI)
+
+For quick operations, use CLI commands:
+
+```bash
+# Start your day
+tt -s
+
+# Add completed tasks
+tt -a "Meeting: Standup"
+tt -a "Education: CKA Labs" -c "Studied networking concepts"
+tt -a "Lunch **"                    # Break task
+tt -a "Commuting ***"               # Ignored task
+
+# View today's report
+tt -r
+
+# Extend last task to current time
+tt -x
+
+# Show help
+tt -h
+```
+
+### Terminal UI (TUI)
+
+For interactive sessions, run without arguments:
+
+```bash
+# Launch beautiful TUI interface
+tt
+```
+
+### TUI Key Commands
 
 #### Navigation
 - `↑/k, ↓/j` - Move up/down
@@ -64,26 +98,53 @@ go install
 - `x` - **Extend last task** (continue working on previous task)
 - `?` - **Toggle help** (show all commands)
 
+### CLI Commands
+
+```bash
+tt                              # Launch TUI interface
+tt -s                           # Start your day
+tt -a "task name"               # Add completed task
+tt -a "task name" -c "comment"  # Add task with comment
+tt -r                           # Show today's report
+tt -x                           # Extend last task
+tt -h                           # Show CLI help
+```
+
 ### Workflow Example
 
-1. **Start your day**
-   ```
-   Press 's' → Creates "Start" entry at current time
-   ```
+#### CLI Workflow (Quick & Scriptable)
+```bash
+# Start your day
+tt -s
 
-2. **Work on tasks** (time passes naturally)
+# Work on tasks throughout the day...
+tt -a "Meeting: Daily standup"
+tt -a "Development: User auth" -c "Implemented JWT tokens"  
+tt -a "Lunch **"
+tt -a "Code review" -c "Reviewed PR #123"
 
-3. **Complete tasks as you finish them**
-   ```
-   Press 'a' → "Meeting: Standup" → Optional comment
-   Duration automatically calculated from last entry
-   ```
+# Check your progress
+tt -r
+```
 
-4. **View your progress**
-   ```
-   Press 'r' → Beautiful report with time breakdown
+#### TUI Workflow (Interactive & Visual)
+1. **Launch interface**
+   ```bash
+   tt
    ```
 
+2. **Start your day** - Press `s`
+
+3. **Work naturally** - Time passes as you focus on tasks
+
+4. **Log completed work** - Press `a` when you finish something
+   - Guided prompts for task name and optional comments
+   - Automatic duration calculation from last entry
+
+5. **Monitor progress** - Press `r` for beautiful reports
+
+6. **Extend if needed** - Press `x` to continue previous task
+
 ### Task Types
 
 The application supports three types of activities:
@@ -105,7 +166,28 @@ Meeting: Daily standup
 
 ## 📊 Interface Overview
 
-### Main Dashboard
+### CLI Report Output
+```
+📊 Today's Report
+================
+
+Work:  3h15
+Break: 0h45
+Total: 4h00
+
+Projects:
+  Meeting: 0h30
+  Education: 1h45
+  Development: 1h00
+
+Activities:
+  09:00-09:30  0h30  Meeting: Standup
+  09:30-11:15  1h45  Education: CKA Labs
+  11:15-12:00  0h45  Lunch ** [BREAK]
+  12:00-13:00  1h00  Development: Bug fixes
+```
+
+### TUI Main Dashboard
 ```
 ⏱️  Time Tracker
 
@@ -126,7 +208,7 @@ Today's Summary:
 Press ? for help, q to quit
 ```
 
-### Task Completion Flow
+### TUI Task Completion Flow
 ```
 ✅ Task Completed
 
@@ -199,7 +281,6 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 ## 🙏 Acknowledgments
 
 - [Charmbracelet](https://charm.sh/) for the amazing TUI toolkit
-- [Conventional Commits](https://conventionalcommits.org/) for inspiration on task categorization
 - The Go community for excellent tooling and libraries
 
 ## 🐛 Issues & Support

go.mod

@@ -1,4 +1,4 @@
-module timetracker
+module tt
 
 go 1.24.2
 

main.go

@@ -2,6 +2,7 @@ package main
 
 import (
 	"encoding/json"
+	"flag"
 	"fmt"
 	"log"
 	"os"
@@ -526,12 +527,27 @@ func (m model) mainViewRender() string {
 
 	// Quick stats
 	stats := m.tracker.getTodaysStats()
-	quickStats := fmt.Sprintf("\n%s\n%s\n%s\n%s\n",
+	quickStats := fmt.Sprintf("\n%s\n%s\n%s\n%s",
 		subtitleStyle.Render("Today's Summary:"),
 		workStyle.Render(fmt.Sprintf("  Work:  %s", formatDuration(stats.WorkTime))),
 		breakStyle.Render(fmt.Sprintf("  Break: %s", formatDuration(stats.BreakTime))),
 		subtitleStyle.Render(fmt.Sprintf("  Total: %s", formatDuration(stats.TotalTime))))
 
+	// Project breakdown for main view
+	projects := m.tracker.getTodaysProjects()
+	// Debug: Always show the projects section to see what's in it
+	quickStats += "\n\n" + subtitleStyle.Render("Projects:")
+	if len(projects) == 0 {
+		quickStats += "\n" + infoStyle.Render("  No projects found")
+	} else {
+		for project, duration := range projects {
+			if project == "" {
+				project = "General"
+			}
+			quickStats += "\n" + workStyle.Render(fmt.Sprintf("  %s: %s", project, formatDuration(duration)))
+		}
+	}
+	
 	// Message
 	var message string
 	if m.message != "" {
@@ -862,6 +878,19 @@ func (tt *TimeTracker) getTodaysStats() struct {
 	}
 }
 
+func (tt *TimeTracker) getTodaysProjects() map[string]time.Duration {
+	activities := tt.getTodaysActivities()
+	projects := make(map[string]time.Duration)
+	
+	for _, activity := range activities {
+		if activity.Type == Work {
+			projects[activity.Project] += activity.Duration
+		}
+	}
+	
+	return projects
+}
+
 func (tt *TimeTracker) generateTodaysSummary() string {
 	stats := tt.getTodaysStats()
 	activities := tt.getTodaysActivities()
@@ -938,7 +967,160 @@ func formatDuration(d time.Duration) string {
 	return fmt.Sprintf("%dh%02d", hours, minutes)
 }
 
+func printCLIHelp() {
+	fmt.Println("tt - Time Tracker")
+	fmt.Println()
+	fmt.Println("USAGE:")
+	fmt.Println("  tt                    Start TUI interface")
+	fmt.Println("  tt [command]          Run command and exit")
+	fmt.Println()
+	fmt.Println("COMMANDS:")
+	fmt.Println("  -s                    Start your day")
+	fmt.Println("  -a \"task name\"        Add completed task")
+	fmt.Println("  -c \"comment\"          Add comment (use with -a)")
+	fmt.Println("  -r                    Show today's report")
+	fmt.Println("  -x                    Extend last task to now")
+	fmt.Println("  -h                    Show this help")
+	fmt.Println()
+	fmt.Println("EXAMPLES:")
+	fmt.Println("  tt -s                 # Start your day")
+	fmt.Println("  tt -a \"Meeting: Standup\"")
+	fmt.Println("  tt -a \"Lunch **\"      # Break task")
+	fmt.Println("  tt -a \"Dev work\" -c \"Fixed login bug\"")
+	fmt.Println("  tt -r                 # View today's report")
+	fmt.Println("  tt -x                 # Extend last task")
+	fmt.Println()
+	fmt.Println("TASK TYPES:")
+	fmt.Println("  Regular task:    \"Meeting: Standup\"")
+	fmt.Println("  Break task:      \"Lunch **\"")
+	fmt.Println("  Ignored task:    \"Commuting ***\"")
+}
+
+func printTodaysReport(tracker *TimeTracker) {
+	activities := tracker.getTodaysActivities()
+	stats := tracker.getTodaysStats()
+	
+	fmt.Println("📊 Today's Report")
+	fmt.Println("================")
+	fmt.Println()
+	
+	// Summary
+	fmt.Printf("Work:  %s\n", formatDuration(stats.WorkTime))
+	fmt.Printf("Break: %s\n", formatDuration(stats.BreakTime))
+	fmt.Printf("Total: %s\n", formatDuration(stats.TotalTime))
+	fmt.Println()
+	
+	// Projects
+	projects := tracker.getTodaysProjects()
+	if len(projects) > 0 {
+		fmt.Println("Projects:")
+		for project, duration := range projects {
+			if project == "" {
+				project = "General"
+			}
+			fmt.Printf("  %s: %s\n", project, formatDuration(duration))
+		}
+		fmt.Println()
+	}
+	
+	// Activities
+	if len(activities) > 0 {
+		fmt.Println("Activities:")
+		for _, activity := range activities {
+			timeStr := activity.Start.Format("15:04") + "-" + activity.End.Format("15:04")
+			typeStr := ""
+			switch activity.Type {
+			case Break:
+				typeStr = " [BREAK]"
+			case Ignored:
+				typeStr = " [IGNORED]"
+			}
+			
+			fmt.Printf("  %s  %s  %s%s\n", 
+				timeStr, 
+				formatDuration(activity.Duration), 
+				activity.Name,
+				typeStr)
+		}
+	} else {
+		fmt.Println("No activities logged today.")
+	}
+}
+
 func main() {
+	// Parse command line flags
+	var (
+		addTask    = flag.String("a", "", "Add a completed task")
+		startDay   = flag.Bool("s", false, "Start your day")
+		showReport = flag.Bool("r", false, "Show today's report")
+		extend     = flag.Bool("x", false, "Extend last task to current time")
+		showHelp   = flag.Bool("h", false, "Show help")
+		comment    = flag.String("c", "", "Add comment to task (use with -a)")
+	)
+	flag.Parse()
+
+	// Handle CLI commands
+	if *showHelp {
+		printCLIHelp()
+		return
+	}
+
+	// Initialize tracker for CLI operations
+	tracker := &TimeTracker{}
+	tracker.loadConfig()
+	tracker.loadEntries()
+
+	if *startDay {
+		err := tracker.addStart()
+		if err != nil {
+			fmt.Printf("Error starting day: %v\n", err)
+			os.Exit(1)
+		}
+		fmt.Println("✅ Day started!")
+		return
+	}
+
+	if *addTask != "" {
+		entry := Entry{
+			Timestamp: time.Now(),
+			Name:      *addTask,
+			Comment:   *comment,
+		}
+		
+		err := tracker.addEntry(entry)
+		if err != nil {
+			fmt.Printf("Error adding task: %v\n", err)
+			os.Exit(1)
+		}
+		
+		// Calculate and show duration
+		var durationMsg string
+		if len(tracker.entries) > 1 {
+			lastEntry := tracker.entries[len(tracker.entries)-2]
+			duration := entry.Timestamp.Sub(lastEntry.Timestamp)
+			durationMsg = fmt.Sprintf(" (%s)", formatDuration(duration))
+		}
+		
+		fmt.Printf("✅ Task completed: %s%s\n", *addTask, durationMsg)
+		return
+	}
+
+	if *extend {
+		err := tracker.extend()
+		if err != nil {
+			fmt.Printf("Error extending task: %v\n", err)
+			os.Exit(1)
+		}
+		fmt.Println("✅ Task extended to current time!")
+		return
+	}
+
+	if *showReport {
+		printTodaysReport(tracker)
+		return
+	}
+
+	// If no CLI flags, start TUI
 	p := tea.NewProgram(initialModel(), tea.WithAltScreen())
 	if _, err := p.Run(); err != nil {
 		log.Fatal(err)