Gemini CLI Data Source (Beta)

Gemini CLI support is experimental while the Gemini CLI log format continues to evolve.

ccusage can read Gemini CLI chat logs as one of its supported local data sources. Gemini uses the same unified and focused report model as Claude Code, Codex, OpenCode, Amp, pi-agent, and GitHub Copilot CLI.

Focused Views

# Daily Gemini CLI usage
ccusage gemini daily

# Monthly Gemini CLI usage
ccusage gemini monthly

# Gemini CLI sessions
ccusage gemini session

Most users can start with unified reports such as ccusage daily. Add the gemini namespace only when you want to focus the same report shape on Gemini CLI usage.

Data Source

The CLI reads Gemini CLI JSON and JSONL files located under GEMINI_DATA_DIR (defaults to ~/.gemini/tmp). GEMINI_DATA_DIR can be one directory or a comma-separated list of directories.

GEMINI_DATA_DIR="$HOME/.gemini/tmp,/backup/gemini/tmp" ccusage gemini daily

~/.gemini/tmp/
└── */
    └── chats/
        ├── *.json
        └── *.jsonl

Report Views

Focused view	Description	See also
ccusage gemini daily	Aggregate usage by date	Daily Usage
ccusage gemini monthly	Aggregate usage by month	Monthly Usage
ccusage gemini session	Group usage by Gemini CLI session	Session Usage

These views support --json, --compact, and --offline.

What Gets Calculated

• Token usage - Gemini token records provide input, output, cached, thought, tool, and total token counts when available.
• Cache tokens - Gemini input values can include cached prompt tokens. ccusage separates those cached tokens into cache read so input and cache read are not double-counted.
• Reasoning tokens - Gemini thoughts tokens are included in total tokens and exposed as reasoningTokens in JSON output. They are priced with output tokens.
• Pricing - Costs are calculated from LiteLLM pricing data for Gemini, Google, Vertex AI, and OpenRouter Gemini model names.

Environment Variables

Variable	Description
GEMINI_DATA_DIR	Override the root directory, or comma-separated root directories, containing Gemini data
LOG_LEVEL	Adjust verbosity (0 silent ... 5 trace)

Troubleshooting

No Gemini CLI usage data found

Ensure Gemini CLI has written chat logs under ~/.gemini/tmp/*/chats/. Set GEMINI_DATA_DIR if your Gemini data lives elsewhere or in multiple archive roots.

Costs showing as $0.00

If a model is not in LiteLLM's database, the cost will be $0.00. Use --offline=false to fetch the latest pricing data, or open an issue to request alias support.