Agent skill

Claude Code Daily Cost Report

by tombelieber in tombelieber/claude-view

Shows today's Claude Code spending through the claude-view MCP server, with total cost, running sessions and a per-session breakdown, and other date ranges on request.

MITAuto-check passedAI & LLM Engineering

Install Claude Code Daily Cost Report

skills CLI
$ npx skills add tombelieber/claude-view --skill daily-cost -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tombelieber/claude-view daily-cost --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tombelieber/claude-view.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/plugin/skills/daily-cost .claude/skills/daily-cost && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
daily-cost
GitHub stars
111
Token cost
~3k tokens
SKILL.md length
1,072 words
Files
2
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Shows today's Claude Code spending through the claude-view MCP server, with total cost, running sessions and a per-session breakdown, and other date ranges on request.

  • Works in 6 steps: Get live summary. Call… → Get per-session details. If there are… → Get dashboard stats. Call… → …
  • Asking how much you have spent on Claude Code today
  • SKILL.md covers Steps and Available Tools
  • Calls npx

What it does

The skill relies on a claude-view server running on localhost, which starts through the plugin hook or with npx claude-view. It first calls get_live_summary for today's aggregate cost and active session counts, then list_live_sessions when sessions are running, to get project, model, cost and agent state for each. It finishes with get_stats using today's date as the start, and presents a Daily Cost Report with the total spent in USD.

If the total is zero it reports that no usage was detected and suggests checking whether the server has indexed recent sessions. For a week or a month it uses the from and to parameters of get_stats. All tool names carry the mcp__claude-view__ prefix, and only three tools are allowed. The excerpt also lists other server tools for session search, token statistics, fluency scores and classification, but the cost report uses the three above.

When your agent uses it

  • Asking how much you have spent on Claude Code today
  • Checking which running sessions are costing the most
  • Getting spend over a custom date range such as this week or last month
  • Producing a short cost report for a budget check

Example prompts

  • “How much did I spend today?”
  • “Give me a cost report for this week.”
  • “Which of my running sessions has cost the most so far today?”
  • “What's my spend for last month, broken down by project?”

Requirements

  • The claude-view MCP server running on localhost
  • Pre-approved tools (allowed-tools): mcp__claude-view__get_live_summary, mcp__claude-view__list_live_sessions, mcp__claude-view__get_stats

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Get live summary. Call mcpclaude-viewget_live_summary to get today's aggregate cost and active session counts.
  2. Get per-session details. If there are running sessions (needs_attention > 0 or autonomous > 0), call mcpclaude-viewlist_live_sessions to…
  3. Get dashboard stats. Call mcpclaude-viewget_stats with from set to today's date (e.g. 2026-03-01) to get today's session breakdown.
  4. Present the cost report in this format
  5. If total cost is $0.00, say "No Claude Code usage detected today" and suggest checking if the claude-view server has indexed recent…
  6. If the user asks about a different time range (e.g. "this week", "last month"), use the from and to parameters on mcpclaude-viewget_stats…

What it can do on your machine

Read from SKILL.md and the folder at commit ff3cdd1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • mcp__claude-view__get_live_summary
    • mcp__claude-view__list_live_sessions
    • mcp__claude-view__get_stats

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Claude Code Daily Cost Report loads about 3k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 1,072 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tombelieber/claude-view at commit ff3cdd1, republished under its MIT licence (© tombelieber). 1,072 words, ~3,033 tokens.

Download SKILL.mdSave it as .claude/skills/daily-cost/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
daily-cost
description
Use when the user asks about cost, spending, or budget — e.g. 'how much did I spend today', 'daily cost', 'cost report', 'what's my spend'
allowed-tools
mcp__claude-view__get_live_summary, mcp__claude-view__list_live_sessions, mcp__claude-view__get_stats

You have access to the claude-view MCP server which provides tools for monitoring, analyzing, and managing Claude Code sessions. The claude-view server must be running on localhost (it auto-starts via the plugin hook).

Important: All tool names are prefixed with mcp__claude-view__. When calling a tool, always use the full prefixed name.

Error handling: If a tool returns an error about the server not being detected, tell the user to start it with npx claude-view.

Daily Cost Report

Show the user's Claude Code spending for today using the claude-view MCP tools.

Steps

  1. Get live summary. Call mcp__claude-view__get_live_summary to get today's aggregate cost and active session counts.

  2. Get per-session details. If there are running sessions (needs_attention > 0 or autonomous > 0), call mcp__claude-view__list_live_sessions to get per-session project, model, cost, and agent state.

  3. Get dashboard stats. Call mcp__claude-view__get_stats with from set to today's date (e.g. 2026-03-01) to get today's session breakdown.

  4. Present the cost report in this format:

## Daily Cost Report — [today's date]

**Total spent today:** $X.XX USD
**Sessions today:** N | **Currently running:** M

### Running sessions
- [project] — [model] — $X.XX — [agent_state]
(per-session data from list_live_sessions)

### Token usage today
- Input: X tokens | Output: Y tokens
- Cache read: Z tokens
  1. If total cost is $0.00, say "No Claude Code usage detected today" and suggest checking if the claude-view server has indexed recent sessions.

  2. If the user asks about a different time range (e.g. "this week", "last month"), use the from and to parameters on mcp__claude-view__get_stats accordingly.

Available Tools

ToolDescription
Session Tools
list_sessionsList sessions with filters
get_sessionGet session details
search_sessionsGrep search across sessions
Stats Tools
get_statsDashboard statistics
get_fluency_scoreAI Fluency Score (0-100)
get_token_statsToken usage statistics
Live Tools
list_live_sessionsCurrently running sessions
get_live_summaryAggregate live session summary
Auth Tools
auth_post_sessionauth session
auth_delete_sessionauth session
auth_get_statusauth status
Classify Tools
classify_start_classificationTrigger a classification job.
classify_cancel_classificationCancel a running classification job.
classify_single_sessionClassify a single session synchronously.
classify_get_classification_statusGet classification status.
Claude Home Tools
claude_home_list_claude_homehome
Cli Tools
cli_create_session- Create a new tmux-backed CLI session.
Coaching Tools
coaching_list_rules- List all coaching rules from the rules directory.
coaching_apply_rule- Create a new coaching rule file.
coaching_remove_rule- Remove a coaching rule file.
Contributions Tools
contributions_get_contributionsMain contributions page data.
contributions_get_branch_sessionsSessions for a branch.
contributions_get_session_contributionSession contribution detail.
Devices Tools
devices_list_devices_handlerdevices
devices_terminate_others_handlerothers
devices_delete_device_handlerdevices {device_id}
Export Tools
export_sessionsExport all sessions.
Facets Tools
facets_facet_badgesQuality badges (outcome + satisfaction) for the requested session IDs
facets_trigger_facet_ingestStart facet ingest from the Claude Code insights cache
facets_pattern_alertCheck the most recent sessions for a negative satisfaction pattern
facets_facet_statsAggregate statistics across all session facets.
Health Tools
health_configconfig
health_checkHealth check endpoint.
health_get_statusGet index metadata and data freshness info.
Ide Tools
ide_get_detectGET /api/ide/detect — return cached list of installed IDEs.
ide_post_openPOST /api/ide/open — open a file in the requested IDE.
Insights Tools
insights_get_insightsCompute and return behavioral insights.
insights_get_benchmarksCompute personal progress benchmarks.
insights_get_categoriesReturns hierarchical category data.
insights_get_insights_modelsper-model usage aggregated from rollup tables.
insights_get_insights_projectsper-project usage aggregated from rollup tables.
insights_get_insights_trendsGet time-series trend data for charts.
insights_list_invocablesList all invocables with their usage counts.
Jobs Tools
jobs_list_jobsList all active jobs.
Live Tools
live_get_pricing- Return the model pricing table.
live_dismiss_all_closed- Dismiss all recently closed (in-memory only).
live_get_live_session- Get a single live session by ID.
live_dismiss_session- Dismiss from recently closed (in-memory only).
live_get_live_session_messages- Get the most recent messages for a live session.
Mcp Tools
mcp_get_mcp_serversreturns all deduplicated MCP server configurations.
Memory Tools
memory_get_all_memoriesreturns all memory entries grouped by scope.
memory_get_memory_fileread a single memory file.
memory_get_project_memoriesreturns memories for a specific project.
Monitor Tools
monitor_snapshot- One-shot JSON snapshot of current resources.
Oauth Tools
oauth_get_auth_identityGET /api/oauth/identity
oauth_get_oauth_usageGET /api/oauth/usage
oauth_post_oauth_usage_refreshPOST /api/oauth/usage/refresh
Pairing Tools
pairing_generate_qrGenerate a QR payload via Supabase pair-offer.
Plans Tools
plans_get_session_plans- returns plan documents for the session's slug.
Plugins Tools
plugins_list_plugins- Unified view of installed + available plugins.
plugins_list_marketplacesplugins marketplaces
plugins_marketplace_actionplugins marketplaces action
plugins_refresh_allall
plugins_refresh_statusstatus
plugins_list_ops_handlerList all queued/running/completed ops.
plugins_enqueue_opEnqueue a plugin mutation, return immediately.
Processes Tools
processes_cleanup_processesprocesses cleanup
processes_kill_processprocesses {pid} kill
Projects Tools
projects_list_projectslist all projects backed by the in-memory catalog.
projects_list_project_branchesList distinct branches with session counts.
projects_list_project_sessionspaginated sessions for one project.
Prompts Tools
prompts_list_promptsList prompt history with optional search/filter.
prompts_get_prompt_statsAggregate prompt statistics.
prompts_get_prompt_templatesDetected prompt templates.
Providers Tools
providers_list_providersproviders with session counts (count > 0 only, Claude Code always first).
providers_usagetoken/cost aggregates per foreign provider within a trailing window
Reports Tools
reports_list_reportsList all saved reports.
reports_get_previewAggregate preview stats for a date range.
reports_get_reportGet a single report.
reports_delete_reportDelete a report.
Sessions Tools
sessions_get_active_sessionsreturns all active session files from ~/.claude/sessions/.
sessions_list_branchesGet distinct list of branch names across all sessions.
sessions_estimate_costcost estimation (Rust-only, no sidecar).
sessions_session_activityActivity histogram for sparkline chart.
sessions_session_activity_richFull server-side activity aggregation.
sessions_bulk_archive_handlersessions archive
sessions_bulk_unarchive_handlersessions unarchive
sessions_archive_session_handlersessions {id} archive
sessions_get_file_historyList all file changes for a session.
sessions_get_file_diffhistory/:file_hash/diff?from=N&to=M
sessions_get_session_hook_eventsFetch hook events for a session.
sessions_get_session_messages_by_idGet paginated messages by session ID.
sessions_get_subagent_messagesPaginated blocks for a sub-agent.
sessions_unarchive_session_handlersessions {id} unarchive
sessions_interact_handlerResolve a pending interaction (permission, question, plan, elicitation).
sessions_get_interaction_handlerFetch the full interaction data for a session's pending interaction.
Settings Tools
settings_get_claude_code_settingsreturns merged, redacted Claude Code settings.
settings_get_settingsRead current app settings.
settings_update_settingsUpdate app settings (partial).
settings_update_git_sync_intervalUpdate the git sync interval.
Share Tools
share_create_sharesessions {session_id} share
share_revoke_sharesessions {session_id} share
share_list_sharesshares
Stats Tools
stats_ai_generation_statsAI generation statistics with time range filtering.
stats_overviewAggregate usage statistics.
stats_storage_statsStorage statistics for the settings page.
stats_get_trendsGet week-over-week trend metrics.
Sync Tools
sync_indexing_status- lightweight JSON snapshot of indexing progress.
sync_trigger_deep_indexTrigger a full deep index rebuild.
sync_trigger_git_syncTrigger git commit scanning (A8.5).
System Tools
system_check_pathCheck whether a filesystem path still exists.
system_get_system_statusGet comprehensive system status.
system_clear_cacheClear obsolete search cache.
system_trigger_git_resyncTrigger full git re-sync.
system_trigger_reindexTrigger a full re-index.
system_reset_allFactory reset all data.
Teams Tools
teams_list_teamsList all teams.
teams_get_teamGet team detail.
teams_get_team_costGet team cost breakdown.
teams_get_team_inboxGet team inbox messages.
teams_get_team_sidechainsGet team member sidechains.
Telemetry Tools
telemetry_set_consentSet telemetry consent preference.
telemetry_ingest_eventingress for web journey events.
Turns Tools
turns_get_session_turns- Per-turn breakdown for a historical session.
Webhooks Tools
webhooks_list_webhookslist all webhooks (secrets excluded).
webhooks_create_webhookcreate a new webhook (returns signing secret once).
webhooks_get_webhookget a single webhook by ID.
webhooks_update_webhookupdate an existing webhook (partial update).
webhooks_delete_webhookremove a webhook from config and secrets.
webhooks_test_sendsend a synthetic test payload.
Workflows Tools
workflows_list_workflowsworkflows
workflows_create_workflowworkflows
workflows_control_runworkflows run {run_id} control
workflows_list_workflow_runsworkflows runs
workflows_get_workflow_run_detailworkflows runs {session_id} {run_id}
workflows_get_workflow_agent_detailworkflows runs {session_id} {run_id} agents {agent_id}
workflows_get_workflowworkflows {id}
workflows_delete_workflowworkflows {id}

© tombelieber, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in packages/plugin/skills/daily-cost of tombelieber/claude-view.

  • SKILL.md
  • SKILL.md.tmpl

Open the folder on GitHubat commit ff3cdd1

Compare with similar skills

Claude Code Daily Cost Report next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Claude Code Daily Cost Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Code Daily Cost Report this skilltombelieber/claude-view111—~3kAutomated safety check: PassMIT
CodexBar Usage Readersteipete/CodexBar22k—~320Automated safety check: PassMIT
Caveman Workflow LabelerJuliusBrussee/caveman111k1 repos~1.3kAutomated safety check: PassApache-2.0
Caveman Evidence ReviewJuliusBrussee/caveman111k1 repos~927Automated safety check: PassApache-2.0
Agents Best PracticesDenisSergeevitch/agents-best-practices2.4k—~7.4kAutomated safety check: PassMIT
Langfuseavivsinai/langfuse-mcp1131 repos~580Automated safety check: PassMIT

Similar skills

  • CodexBar Usage Reader

    steipete/CodexBar

    CodexBar read. Provider usage, limits, credits, config health. JSON. No writes.

    22k GitHub stars~320 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Caveman Workflow Labeler

    JuliusBrussee/caveman

    Finds every LLM workflow in a repository, proposes a labeling table and, once you agree, wires labels so Caveman Cloud groups spend per workflow.

    111k GitHub starsUsed in 1 repo~1.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Caveman Evidence Review

    JuliusBrussee/caveman

    Read-only review of Caveman Cloud data to explain where LLM spend goes: cost, score, workflows, traces, latency, errors, routing and verified savings.

    111k GitHub starsUsed in 1 repo~927 tokens
    AI & LLM EngineeringAuto-check passed
  • Agents Best Practices

    DenisSergeevitch/agents-best-practices

    A skill your agent uses when designing, generating an MVP blueprint for, auditing, troubleshooting, refactoring, or explaining an agentic harness for any domain.

    2.4k GitHub stars~7.4k tokensUpdated 6 days ago
    AI & LLM EngineeringAuto-check passed
  • Langfuse

    avivsinai/langfuse-mcp

    Investigate AI traces, observations, exceptions, latency, sessions, prompts, datasets, annotation queues, and scores through Langfuse MCP.

    113 GitHub starsUsed in 1 repo~580 tokens
    AI & LLM EngineeringAuto-check passed
  • Omni

    fajarhide/omni

    A skill your agent uses when installing, verifying or configuring OMNI, when command output carries an [OMNI: ...] marker, or when output looks shorter than expected.

    366 GitHub stars~1.1k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from tombelieber/claude-view

All 13 skills in this repo
  • Claude View Coaching

    tombelieber/claude-view

    Reviews your Claude Code habits through the claude-view server, showing an AI Fluency Score and insights and letting you add or remove personal coaching rules.

    111 GitHub stars~3.1k tokensUpdated 10 days ago
    Auto-check passed
  • Export Claude Sessions

    tombelieber/claude-view

    Exports Claude Code session history from the claude-view server as JSON, filtered by date range or project, for backup or analysis elsewhere.

    111 GitHub stars~2.9k tokensUpdated 10 days ago
    Auto-check passed
  • Claude Code Behavioral Insights

    tombelieber/claude-view

    Pulls pattern, trend and benchmark data from the claude-view MCP server to present a behavioral analysis of your Claude Code usage, grouped by category.

    111 GitHub stars~3.1k tokensUpdated 10 days ago
    Auto-check passed
  • claude-view Project Overview

    tombelieber/claude-view

    Shows a dashboard for one project, or a table of all projects, from the claude-view MCP server: sessions, branches and contribution data.

    111 GitHub stars~3.1k tokensUpdated 10 days ago
    Auto-check passed
  • Claude Session Search

    tombelieber/claude-view

    Search your Claude Code session history through the claude-view MCP server, matching summaries, commit messages and project or branch names, and present the most relevant sessions.

    111 GitHub stars~3k tokensUpdated 10 days ago
    Auto-check passed
  • Session Recap

    tombelieber/claude-view

    A skill your agent uses when the user asks to recap, summarize, or review a Claude Code session — e.g.

    111 GitHub stars~3k tokensUpdated 10 days ago
    Auto-check passed

Questions about Claude Code Daily Cost Report

What does Claude Code Daily Cost Report do?

Shows today's Claude Code spending through the claude-view MCP server, with total cost, running sessions and a per-session breakdown, and other date ranges on request. The skill relies on a claude-view server running on localhost, which starts through the plugin hook or with npx claude-view. It first calls get_live_summary for today's aggregate cost and active session counts, then list_live_sessions when sessions are running, to get project, model, cost and agent state for each.

When should I use Claude Code Daily Cost Report?

Claude Code Daily Cost Report fits situations like: asking how much you have spent on Claude Code today; checking which running sessions are costing the most; getting spend over a custom date range such as this week or last month; producing a short cost report for a budget check.

How do I install Claude Code Daily Cost Report in Claude Code?

Run `npx skills add tombelieber/claude-view --skill daily-cost -a claude-code`. Or copy the skill folder (packages/plugin/skills/daily-cost in tombelieber/claude-view) into .claude/skills/daily-cost in your project. Claude Code loads it when a task matches its description.

How do I install Claude Code Daily Cost Report in Codex?

Run `npx skills add tombelieber/claude-view --skill daily-cost -a codex`. Or copy the skill folder (packages/plugin/skills/daily-cost in tombelieber/claude-view) into .agents/skills/daily-cost in your project. Codex loads it when a task matches its description.

Can I use Claude Code Daily Cost Report in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tombelieber/claude-view --skill daily-cost -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/daily-cost, .gemini/skills/daily-cost, .github/skills/daily-cost and .opencode/skills/daily-cost in your project.

What does Claude Code Daily Cost Report need to run?

Going by SKILL.md and its folder, Claude Code Daily Cost Report needs the command-line tools its instructions call (npx). Our summary lists: The claude-view MCP server running on localhost. Its frontmatter pre-approves these tools: mcp__claude-view__get_live_summary, mcp__claude-view__list_live_sessions, mcp__claude-view__get_stats.

Does Claude Code Daily Cost Report access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Claude Code Daily Cost Report safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Claude Code Daily Cost Report use?

Claude Code Daily Cost Report is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Claude Code Daily Cost Report use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Claude Code Daily Cost Report?

Skills that share tags, products or a category with Claude Code Daily Cost Report: CodexBar Usage Reader (steipete/CodexBar, 22k stars), Caveman Workflow Labeler (JuliusBrussee/caveman, 111k stars), Caveman Evidence Review (JuliusBrussee/caveman, 111k stars) and Agents Best Practices (DenisSergeevitch/agents-best-practices, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Code Daily Cost Report?

tombelieber (a GitHub user) maintains it in tombelieber/claude-view, which has 111 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 30, 2026.

Source: tombelieber/claude-view on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.