# add token profile diagnostics

`2380303`·

peyton-alt·3w ago·3 files·+645 added/-0 removed

## Sessions

cdebea3708fdView transcript

## Changes

3

- cmd/entire/cli

- Mroot.go+1
  - Atokens\_profile.go+413
  - Atokens\_profile\_test.go+231

```go
83 unmodified lines

84
85
86
87
88
89
90

83 unmodified lines

// 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)
```

```go
package cli

import (
	"context"
	"encoding/json"
	"errors"
	"fmt"
	"io"
	"github.com/entireio/cli/cmd/entire/cli/agent"
	"github.com/entireio/cli/cmd/entire/cli/checkpoint"
	"github.com/entireio/cli/cmd/entire/cli/checkpoint/id"
	"github.com/spf13/cobra"
)

type tokensProfileReport struct {
	Source                   string                        `json:"source"`
	CheckpointsAvailable     int                           `json:"checkpoints_available"`
	CheckpointsAnalyzed      int                           `json:"checkpoints_analyzed"`
	CheckpointsWithTokenData int                           `json:"checkpoints_with_token_data"`
	MissingTokenData         int                           `json:"missing_token_data"`
	MetadataReadWarnings     int                           `json:"metadata_read_warnings,omitempty"`
	Tokens                   *sessionTokensUsage           `json:"tokens,omitempty"`
	Signals                  []tokensProfileSignal         `json:"signals,omitempty"`
	Recommendations          []sessionTokensRecommendation `json:"recommendations,omitempty"`
	Limitations              []string                      `json:"limitations,omitempty"`
}

// Remaining functions and types continue here...

func newTokensGroupCmd() *cobra.Command {
	cmd := &cobra.Command{
		Use:   "tokens",
		Short: "Analyze token usage across sessions and checkpoints",
		Long:  `Analyze token usage across sessions and checkpoints.`,
		Args: cobra.NoArgs,
	}
	return cmd
}

// Further code details...

```