overview

A command-line dashboard for Pulumi cloud infrastructure projects. Pulumi is a tool that defines and manages cloud resources using code.

In plain words
What is it for?
For reviewing cloud costs from Pulumi state and preview files, filtering resources or plugins, choosing date ranges, and exporting table, JSON, or line-by-line JSON output.
Why use it?
It brings current infrastructure state, planned changes, real spending, expected spending, differences, and recommendations into one view.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/rshade/finfocus/overview
Clone the repo
git clone --depth 1 https://github.com/rshade/finfocus
Per session 18 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,600 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00018 $0.02600
Opus 5 $0.00009 $0.01300
Sonnet 5 $0.00004 $0.00520
Haiku 4.5 $0.00002 $0.00260

Measured 2d ago against content hash f5775605ddf9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

overview scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

docs/src/content/docs/commands/overview.md · 325 lines

How it starts

The opening of the file, as written. The whole thing — 325 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Display a unified cost dashboard combining Pulumi state and plan data with actual costs, projected costs, drift analysis, and recommendations.

Usage

finfocus overview [options]

All flags are optional. When --pulumi-state and --pulumi-json are omitted, the command auto-detects your Pulumi project and stack from the current directory.

Tip: Running finfocus with no arguments inside a Pulumi project directory automatically launches the overview — no subcommand needed.

Options

Flag Description Default
--pulumi-state Path to Pulumi state JSON (skips auto-detection) Auto-detected
--pulumi-json Path to Pulumi preview JSON (skips auto-detection) Auto-detected
--stack Pulumi stack name for auto-detection (ignored with --pulumi-state/--pulumi-json) Current stack
--from Start date (YYYY-MM-DD or RFC3339) 1st of current month
--to End date (YYYY-MM-DD or RFC3339) Now
--adapter Restrict to a specific adapter plugin All plugins
--output Output format: table, json, ndjson table
--filter Resource filters (repeatable) -
--plain Force non-interactive plain text output false
--yes, -y Skip confirmation prompts false
--cache-ttl Cache TTL in seconds; 0 disables caching 0 (disabled)
--no-pagination Disable pagination (plain mode only) false
--exit-on-threshold Exit non-zero when budget threshold exceeded false
--exit-code Exit code for threshold breach (0-255) 1
--state-only Skip pulumi preview (faster, no pending change detection) false
--budget-scope Filter budget scopes: global, provider, tag, type All

Auto-Detection

When no --pulumi-state or --pulumi-json flags are provided, finfocus overview locates your Pulumi project automatically:

  1. Walks up from the current directory to find Pulumi.yaml.
  2. Runs pulumi stack export to fetch the current state JSON.
  3. Runs pulumi preview --json to fetch the pending-change plan.
  4. Uses --stack to select a non-default stack (e.g., --stack production).

Read the full file on GitHub · 325 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 325 lines · 18 tokens per session scan A f5775605ddf9

Subscribe to this mod's changes

overview is a command published in the GitHub repository rshade/finfocus (5 stars, last pushed 16d ago), licensed Apache-2.0. It adds 18 tokens to every session and 2,600 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.