Implement lifetime savings badge and gain share flag

Before this commit, there was no centralized helper to calculate lifetime token and financial savings in the CLI. Furthermore, the REPL shell prompt only showed the Caveman Mode level (lacking visual feedback on cumulative performance gains), and there was no way to export or share a single-line summary of token optimization benefits.

We implemented a centralized GetLifetimeSavings() helper inside internal/observability/observer.go which parses the local savings logs. We then integrated this helper into internal/repl/chat_repl.go to display a lifetime savings badge (e.g. ⛏12.4k) directly inside the readline prompt next to the Caveman level. Finally, we added a --share flag to gptcode gain to output a single-line tweetable optimization summary (inspired by caveman-stats).

An ideal solution would support automatic sharing integration (e.g., opening a browser window to Twitter/X with pre-filled tweet text) and cache lifetime metrics in memory to avoid parsing the savings JSONL file on every prompt render.

Author: Test

cmd/gptcode/gain.go

@@ -19,6 +19,8 @@ type SavingsRecord struct {
 	CostSaved   float64 `json:"cost_saved"`
 }
 
+var shareFlag bool
+
 var gainCmd = &cobra.Command{
 	Use:   "gain",
 	Short: "Show cumulative token and cost savings from command optimization",
@@ -74,6 +76,19 @@ and count of commands optimized by the GPTCode output filtering engine (adapted
 			return err
 		}
 
+		if shareFlag {
+			savingsStr := ""
+			if totalTokensSaved >= 1000000 {
+				savingsStr = fmt.Sprintf("%.1fM", float64(totalTokensSaved)/1000000.0)
+			} else if totalTokensSaved >= 1000 {
+				savingsStr = fmt.Sprintf("%.1fk", float64(totalTokensSaved)/1000.0)
+			} else {
+				savingsStr = fmt.Sprintf("%d", totalTokensSaved)
+			}
+			fmt.Printf("⛏ saved %s tokens ($%.4f) using @gptcode token optimization! why use many token when few do trick\n", savingsStr, totalCostSaved)
+			return nil
+		}
+
 		fmt.Println("============================================================")
 		fmt.Println("                GPTCode Token Savings Report")
 		fmt.Println("============================================================")
@@ -94,3 +109,7 @@ and count of commands optimized by the GPTCode output filtering engine (adapted
 		return nil
 	},
 }
+
+func init() {
+	gainCmd.Flags().BoolVarP(&shareFlag, "share", "s", false, "Print a shareable/tweetable savings badge line")
+}

internal/observability/observer.go

@@ -1,6 +1,7 @@
 package observability
 
 import (
+	"bufio"
 	"encoding/json"
 	"fmt"
 	"os"
@@ -604,3 +605,32 @@ func (o *AgentObserver) recordSavingsToDisk(toolName string, tokensSaved int, co
 
 	_, _ = f.Write(append(data, '\n'))
 }
+
+// GetLifetimeSavings parses the savings file and aggregates tokens and cost saved
+func GetLifetimeSavings() (int, float64, error) {
+	home, err := os.UserHomeDir()
+	if err != nil {
+		return 0, 0, err
+	}
+	savingsFile := filepath.Join(home, ".gptcode", "savings.jsonl")
+	file, err := os.Open(savingsFile)
+	if err != nil {
+		if os.IsNotExist(err) {
+			return 0, 0, nil
+		}
+		return 0, 0, err
+	}
+	defer file.Close()
+
+	var totalTokens int
+	var totalCost float64
+	scanner := bufio.NewScanner(file)
+	for scanner.Scan() {
+		var record SavingsRecord
+		if err := json.Unmarshal([]byte(scanner.Text()), &record); err == nil {
+			totalTokens += record.TokensSaved
+			totalCost += record.CostSaved
+		}
+	}
+	return totalTokens, totalCost, scanner.Err()
+}

internal/repl/chat_repl.go

@@ -11,6 +11,7 @@ import (
 	"gptcode/internal/config"
 	"gptcode/internal/llm"
 	"gptcode/internal/modes"
+	"gptcode/internal/observability"
 	"gptcode/internal/prompt"
 )
 
@@ -411,8 +412,23 @@ func RunSingleShot(input string, args []string) error {
 func (r *ChatREPL) updatePrompt() {
 	setup, err := config.LoadSetup()
 	promptStr := "> "
+
+	// Try loading lifetime savings
+	savingsStr := ""
+	if tokens, _, err := observability.GetLifetimeSavings(); err == nil && tokens > 0 {
+		if tokens >= 1000000 {
+			savingsStr = fmt.Sprintf(" | ⛏%.1fM", float64(tokens)/1000000.0)
+		} else if tokens >= 1000 {
+			savingsStr = fmt.Sprintf(" | ⛏%.1fk", float64(tokens)/1000.0)
+		} else {
+			savingsStr = fmt.Sprintf(" | ⛏%d", tokens)
+		}
+	}
+
 	if err == nil && setup.Defaults.CavemanMode != "" && setup.Defaults.CavemanMode != "off" {
-		promptStr = fmt.Sprintf("(caveman:%s) > ", setup.Defaults.CavemanMode)
+		promptStr = fmt.Sprintf("(caveman:%s%s) > ", setup.Defaults.CavemanMode, savingsStr)
+	} else if savingsStr != "" {
+		promptStr = fmt.Sprintf("(%s) > ", strings.TrimPrefix(savingsStr, " | "))
 	}
 	r.rl.SetPrompt(promptStr)
 }