[codex] add token profile history diagnostics

CLAUDE.md

@@ -22,15 +22,16 @@ This repo contains the CLI for Entire.
 
 ### Command Layout
 
-The CLI is organized around five noun groups plus a small set of top-level
+The CLI is organized around six noun groups plus a small set of top-level
 verbs. The groups are the canonical home for each verb; legacy top-level
 shortcuts remain functional but hidden, and emit a deprecation hint pointing
 at the canonical group form.
 
-- `session` (alias: `sessions`): `list`, `info`, `stop`, `attach`, `resume`, `current`
-- `checkpoint` (aliases: `cp`, `checkpoints`): `list`, `explain`, `search`, plus
+- `session` (alias: `sessions`): `list`, `info`, `tokens`, `stop`, `attach`, `resume`, `current`
+- `checkpoint` (aliases: `cp`, `checkpoints`): `list`, `explain`, `tokens`, `search`, plus
   the deprecated `rewind` (functional, prints a cobra deprecation message, will
   be removed in a future release)
+- `tokens`: `profile`
 - `agent`: bare opens the interactive agent selector, plus `list`, `add`, `remove`
 - `configure`: bare prints help and a hint pointing at `entire agent`; flags
   manage non-agent settings (telemetry, git-hook installation mode, strategy

cmd/entire/cli/root.go

@@ -84,6 +84,7 @@ func NewRootCmd() *cobra.Command {
 	// Noun groups (canonical homes for subcommands).
 	cmd.AddCommand(newSessionsCmd())        // 'session' (with 'sessions' as Cobra alias)
 	cmd.AddCommand(newCheckpointGroupCmd()) // 'checkpoint' / 'cp' / 'checkpoints'
+	cmd.AddCommand(newTokensGroupCmd())     // 'tokens'
 	cmd.AddCommand(newAgentGroupCmd())      // 'agent'
 	cmd.AddCommand(newAuthCmd())            // 'auth'
 	cmd.AddCommand(newDoctorCmd())          // 'doctor' (group: trace/logs/bundle)

cmd/entire/cli/session_tokens.go

@@ -489,8 +489,12 @@ func writeTokenRecommendations(w io.Writer, recs []sessionTokensRecommendation)
 }
 
 func writeTokenUsageSection(w io.Writer, tokens *sessionTokensUsage) {
+	writeTokenUsageSectionWithTitle(w, "Token usage", tokens)
+}
+
+func writeTokenUsageSectionWithTitle(w io.Writer, title string, tokens *sessionTokensUsage) {
 	fmt.Fprintln(w)
-	fmt.Fprintln(w, "Token usage")
+	fmt.Fprintln(w, title)
 	if tokens != nil {
 		fmt.Fprintf(w, "Total:  %s tokens\n", formatTokenCount(tokens.Total))
 		parts := []string{