CLI Commands Reference

Complete command reference for FinFocus.

Commands Overview

finfocus                    # Auto-detects Pulumi project; opens overview if found, otherwise shows help
finfocus overview           # Unified cost dashboard (alias: ov)
finfocus cost               # Cost commands
finfocus cost projected     # Estimate costs from plan
finfocus cost actual        # Get actual historical costs
finfocus cost estimate      # What-if cost analysis
finfocus cost recommendations          # Get cost optimization recommendations
finfocus cost recommendations dismiss  # Dismiss a recommendation
finfocus cost recommendations snooze   # Snooze a recommendation
finfocus cost recommendations undismiss # Re-enable a dismissed recommendation
finfocus cost recommendations history  # View recommendation lifecycle history
finfocus config             # Configuration commands
finfocus config init        # Initialize configuration file with defaults
finfocus config set         # Set a configuration value
finfocus config get         # Get a configuration value
finfocus config list        # List all configuration values
finfocus config validate    # Validate routing configuration
finfocus config routes      # Routing inspection commands
finfocus config routes list # Show effective routing rules
finfocus config routes test # Simulate plugin selection for a resource type
finfocus plugin             # Plugin commands
finfocus plugin init        # Initialize a new plugin
finfocus plugin install     # Install a plugin
finfocus plugin update      # Update a plugin
finfocus plugin remove      # Remove a plugin
finfocus plugin list        # List installed plugins
finfocus plugin inspect     # Inspect plugin capabilities
finfocus plugin validate    # Validate plugin setup
finfocus plugin conformance # Run conformance tests
finfocus plugin certify     # Run certification tests
finfocus analyzer           # Analyzer commands
finfocus analyzer install   # Install the Pulumi analyzer plugin
finfocus analyzer uninstall # Uninstall the Pulumi analyzer plugin
finfocus analyzer serve     # Start the analyzer gRPC server

overview

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

When run inside a Pulumi project directory without explicit file flags, finfocus overview auto-detects the project and current stack, then runs pulumi stack export and pulumi preview --json automatically. Running finfocus with no arguments has the same effect when a Pulumi project is detected.

Alias: ov

Usage (overview)

finfocus overview [options]
finfocus ov [options]
finfocus                    # same as overview when inside a Pulumi project

Options (overview)

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
--no-pagination	Disable pagination (plain mode only)	false

Examples (overview)

# Auto-detect from current Pulumi project (recommended)
finfocus overview

# Same — bare invocation inside a Pulumi project
finfocus

# Select a non-default stack
finfocus overview --stack production

# Use pre-exported files
finfocus overview --pulumi-state state.json --pulumi-json plan.json

# CI/CD: non-interactive JSON output
finfocus overview --output json --yes

# Filter to a single provider
finfocus overview --filter provider=aws --plain --yes

# Custom date range
finfocus overview --from 2026-01-01 --to 2026-01-31 --plain --yes

cost projected

Calculate estimated costs from Pulumi plan. When --pulumi-json is omitted, FinFocus auto-detects the Pulumi project and runs pulumi preview --json.

Usage (cost projected)

finfocus cost projected [options]

Options (cost projected)

Flag	Description	Default
--pulumi-json	Path to Pulumi preview JSON (optional; auto-detected if omitted)
--stack	Pulumi stack name for auto-detection (ignored with —pulumi-json)
--filter	Filter resources (tag:key=value, type=*)	None
--output	Output format: table, json, ndjson	table
--utilization	Assumed resource utilization (0.0-1.0)	1.0
--help	Show help

Examples (cost projected)

# Auto-detect from Pulumi project
finfocus cost projected

# Specific stack
finfocus cost projected --stack production

# Explicit file (existing behavior)
finfocus cost projected --pulumi-json plan.json

# JSON output
finfocus cost projected --pulumi-json plan.json --output json

# Filter by type
finfocus cost projected --pulumi-json plan.json --filter "type=aws:ec2*"

# NDJSON for pipelines
finfocus cost projected --pulumi-json plan.json --output ndjson

cost recommendations

Display cost optimization recommendations from cloud providers.

Usage (cost recommendations)

finfocus cost recommendations --pulumi-json <file> [options]

Options (cost recommendations)

Flag	Description	Default
--pulumi-json	Path to Pulumi preview JSON	Required
--filter	Filter expression (e.g., action=RIGHTSIZE,TERMINATE)	None
--output	Output format: table, json, ndjson	table
--limit	Limit number of recommendations	0 (all)
--verbose	Show all recommendations with full details	false
--include-dismissed	Show dismissed and snoozed recommendations alongside active ones	false
--sort	Sort expression (e.g., savings:desc)	None
--help	Show help

Subcommands (cost recommendations)

Subcommand	Description
dismiss	Permanently dismiss a recommendation
snooze	Snooze a recommendation until a date
undismiss	Re-enable a dismissed recommendation
history	View lifecycle history for a recommendation

Examples (cost recommendations)

# Interactive mode (default)
finfocus cost recommendations --pulumi-json plan.json

# Filter by action type
finfocus cost recommendations --pulumi-json plan.json --filter "action=RIGHTSIZE,TERMINATE"

# JSON output
finfocus cost recommendations --pulumi-json plan.json --output json

# Include dismissed and snoozed recommendations
finfocus cost recommendations --pulumi-json plan.json --include-dismissed

cost recommendations dismiss

Permanently dismiss a recommendation with a reason.

Usage (cost recommendations dismiss)

finfocus cost recommendations dismiss <recommendation-id> [options]

Options (cost recommendations dismiss)

Flag	Description	Default
-r, --reason	Dismissal reason (required)	Required
-n, --note	Free-text explanation (required for other reason)	None
-f, --force	Skip confirmation prompt	false
--pulumi-json	Path to Pulumi preview JSON (for plugin communication)	None
--adapter	Use specific adapter plugin	None

Valid Reasons

Reason	Description
not-applicable	Recommendation doesn’t apply
already-implemented	Already acted on this recommendation
business-constraint	Business requirements prevent action
technical-constraint	Technical limitations prevent action
deferred	Will address later
inaccurate	Recommendation data is wrong
other	Custom reason (requires --note)

Examples (cost recommendations dismiss)

# Dismiss with a reason
finfocus cost recommendations dismiss rec-123abc \
  --reason business-constraint --pulumi-json plan.json

# Dismiss with a custom note
finfocus cost recommendations dismiss rec-123abc \
  --reason other --note "Intentional oversizing" --pulumi-json plan.json

# Skip confirmation prompt
finfocus cost recommendations dismiss rec-123abc \
  --reason not-applicable --force --pulumi-json plan.json

cost recommendations snooze

Temporarily dismiss a recommendation until a future date.

Usage (cost recommendations snooze)

finfocus cost recommendations snooze <recommendation-id> [options]

Options (cost recommendations snooze)

Flag	Description	Default
--until	Snooze until date (required, YYYY-MM-DD or RFC3339; must be in the future)	Required
-r, --reason	Dismissal reason	deferred
-n, --note	Free-text explanation	None
-f, --force	Skip confirmation prompt	false
--pulumi-json	Path to Pulumi preview JSON (for plugin communication)	None
--adapter	Use specific adapter plugin	None

Examples (cost recommendations snooze)

# Snooze until a specific date (replace with a future date)
finfocus cost recommendations snooze rec-456def \
  --until YYYY-MM-DD --pulumi-json plan.json

# Snooze with reason and note (replace with a future date)
finfocus cost recommendations snooze rec-456def \
  --until YYYY-MM-DD --reason deferred \
  --note "Scheduled for Q2 review" --pulumi-json plan.json

cost recommendations undismiss

Re-enable a previously dismissed or snoozed recommendation.

Usage (cost recommendations undismiss)

finfocus cost recommendations undismiss <recommendation-id> [options]

Options (cost recommendations undismiss)

Flag	Description	Default
-f, --force	Skip confirmation prompt	false

Examples (cost recommendations undismiss)

# Re-enable a dismissed recommendation
finfocus cost recommendations undismiss rec-123abc

cost recommendations history

View the lifecycle history of a specific recommendation.

Usage (cost recommendations history)

finfocus cost recommendations history <recommendation-id> [options]

Options (cost recommendations history)

Flag	Description	Default
--output	Output format: table, json, ndjson	table

Examples (cost recommendations history)

# View history in table format
finfocus cost recommendations history rec-123abc

# View history as JSON
finfocus cost recommendations history rec-123abc --output json

# View history as NDJSON (one JSON object per line)
finfocus cost recommendations history rec-123abc --output ndjson

cost actual

Get actual historical costs from plugins. When --pulumi-json and --pulumi-state are both omitted, FinFocus auto-detects the Pulumi project and runs pulumi stack export.

Usage (cost actual)

finfocus cost actual [options]

Options (cost actual)

Flag	Description	Default
--pulumi-json	Path to Pulumi preview JSON (mutually exclusive with —pulumi-state)
--pulumi-state	Path to Pulumi state JSON from pulumi stack export
--stack	Pulumi stack name for auto-detection (ignored with —pulumi-json/—pulumi-state)
--from	Start date (YYYY-MM-DD or RFC3339; auto-detected from state if omitted)
--to	End date (YYYY-MM-DD or RFC3339)	Now
--filter	Filter resources (tag:key=value, type=*)	None
--group-by	Group results (resource, type, provider, daily, monthly)
--output	Output format: table, json, ndjson	table
--estimate-confidence	Show confidence level for cost estimates	false
--help	Show help

Confidence Levels

When --estimate-confidence is enabled, a Confidence column appears showing data reliability:

Level	Description
HIGH	Real billing data from plugin (AWS Cost Explorer, Kubecost)
MEDIUM	Runtime estimate for Pulumi-created resources
LOW	Runtime estimate for imported resources (creation time unknown)

Examples (cost actual)

# Auto-detect from Pulumi project (dates auto-detected from state)
finfocus cost actual

# Auto-detect with specific stack
finfocus cost actual --stack production

# Estimate costs from Pulumi state (--from auto-detected from timestamps)
finfocus cost actual --pulumi-state state.json

# Estimate costs from state with explicit date range
finfocus cost actual --pulumi-state state.json --from 2025-01-01 --to 2025-01-31

# Get costs from Pulumi plan
finfocus cost actual --pulumi-json plan.json --from 2025-01-01

# Group by day
finfocus cost actual --pulumi-json plan.json --group-by daily --from 2025-01-01 --to 2025-01-31

# Group by provider
finfocus cost actual --pulumi-json plan.json --from 2025-01-01 --group-by provider

# Filter by tag
finfocus cost actual --pulumi-json plan.json --from 2025-01-01 --filter "tag:env=prod"

# JSON output
finfocus cost actual --pulumi-json plan.json --from 2025-01-01 --output json

# Show estimate confidence levels (useful for imported resources)
finfocus cost actual --pulumi-state state.json --estimate-confidence

cost estimate

Perform what-if cost analysis on resources without modifying Pulumi code.

Usage (cost estimate)

finfocus cost estimate [options]

Modes

The command supports two mutually exclusive modes:

Single-Resource Mode:

• Specify --provider and --resource-type to estimate cost for a single resource
• Use --property to specify property overrides (repeatable)

Plan-Based Mode:

• Specify --pulumi-json to load resources from a Pulumi plan
• Use --modify to apply modifications to specific resources

Options (cost estimate)

Flag	Description	Default
--provider	Cloud provider (aws, gcp, azure)
--resource-type	Resource type (e.g., ec2:Instance)
--property	Property override key=value (repeatable)
--pulumi-json	Path to Pulumi preview JSON
--modify	Resource modification resource:key=value
--region	Region for cost calculation
--interactive	Launch interactive TUI mode	false
--output	Output format: table, json, ndjson	table
--adapter	Specific plugin adapter to use
--help	Show help

Examples (cost estimate)

# Single resource estimation - estimate cost of changing instance type
finfocus cost estimate --provider aws --resource-type ec2:Instance \
  --property instanceType=m5.large

# Single resource with region
finfocus cost estimate --provider aws --resource-type ec2:Instance \
  --property instanceType=m5.large --region us-west-2

# Plan-based estimation - modify a specific resource in existing plan
finfocus cost estimate --pulumi-json plan.json \
  --modify "web-server:instanceType=m5.large"

# Plan-based with multiple modifications
finfocus cost estimate --pulumi-json plan.json \
  --modify "web-server:instanceType=m5.large" \
  --modify "api-server:instanceType=c5.xlarge"

# Interactive TUI mode
finfocus cost estimate --interactive

# Interactive mode with plan
finfocus cost estimate --pulumi-json plan.json --interactive

# JSON output for scripting
finfocus cost estimate --provider aws --resource-type ec2:Instance \
  --property instanceType=m5.large --output json

Output Example

What-If Cost Analysis
=====================

Resource: ec2:Instance (aws)
ID: estimate-resource

Baseline:  $8.32/mo (USD)
Modified:  $83.22/mo (USD)

Change:    +$74.90/mo

Property Changes:
-----------------
  instanceType: t3.micro -> m5.large (+$74.90/mo)

Interactive Mode

The interactive TUI mode allows you to:

• Navigate through resource properties with arrow keys
• Edit property values inline (press Enter to edit)
• See live cost updates as you modify properties
• Press ‘q’ or Ctrl+C to exit

config init

Initialize a configuration file with default values. When run inside a Pulumi project, creates project-local configuration at $PROJECT/.finfocus/config.yaml along with a .gitignore to protect user-specific data. Use --global to force global initialization even inside a project.

Usage (config init)

finfocus config init [options]

Options (config init)

Flag	Description	Default
--global	Force global config init even inside a Pulumi project	false
--force	Overwrite existing configuration file	false

Examples (config init)

# Create project-local config (inside a Pulumi project)
finfocus config init

# Create global config
finfocus config init --global

# Overwrite existing config
finfocus config init --force

config set

Set a configuration value using dot notation. Writes to ~/.finfocus/config.yaml (or the project-local config when inside a Pulumi project).

For sensitive values such as API keys, use environment variables instead of storing them in config files.

Usage (config set)

finfocus config set <key> <value>

Examples (config set)

# Set output format
finfocus config set output.default_format json

# Set plugin configuration
finfocus config set plugins.aws.region us-west-2

# Set logging level
finfocus config set logging.level debug

# For sensitive values, prefer environment variables
export FINFOCUS_PLUGIN_AWS_SECRET_KEY="mysecret"

config get

Get a configuration value using dot notation from ~/.finfocus/config.yaml.

Usage (config get)

finfocus config get <key>

Examples (config get)

# Get output format
finfocus config get output.default_format

# Get a plugin section
finfocus config get plugins.aws

# Get all plugins
finfocus config get plugins

# Get logging level
finfocus config get logging.level

config list

List all configuration values from ~/.finfocus/config.yaml.

Usage (config list)

finfocus config list [options]

Options (config list)

Flag	Description	Default
--format	Output format: yaml or json	yaml

Examples (config list)

# List all configuration in YAML format (default)
finfocus config list

# List all configuration in JSON format
finfocus config list --format json

config validate

Validate routing configuration for errors and warnings.

Usage (config validate)

finfocus config validate [options]

Options (config validate)

Flag	Description
--help	Show help

Examples (config validate)

# Validate routing configuration
finfocus config validate

# Success output:
# ✓ Configuration valid
#
# Discovered plugins:
#   aws-ce: Recommendations, ActualCosts (priority: 20)
#   aws-public: ProjectedCosts, ActualCosts (priority: 10)
#
# Routing rules:
#   aws:eks:* → eks-costs (pattern, priority: 30)
#   aws:* → aws-public (provider, priority: 10)

# Error output:
# ✗ Configuration invalid
#
# Errors:
#   - aws-ce: plugin not found
#   - patterns[0].pattern: invalid regex: missing closing bracket
#
# Warnings:
#   - aws-public: feature 'Carbon' not supported by plugin
#   - eks-costs: duplicate plugin configuration found

config routes list

Display effective plugin routing rules.

Usage (config routes list)

finfocus config routes list [--output table|json]

Options (config routes list)

Flag	Description	Default
--output	Output format: table or json	table

Examples (config routes list)

# Show routing as a table
finfocus config routes list

# Show routing in JSON
finfocus config routes list --output json

config routes test

Simulate plugin selection for a resource type and view match reasons.

Usage (config routes test)

finfocus config routes test <resource-type> [region] [--output table|json]

Arguments (config routes test)

Argument	Required	Description
resource-type	Yes	Pulumi type token (for example aws:ec2:Instance)
region	No	Region hint (for example us-east-1)

Options (config routes test)

Flag	Description	Default
--output	Output format: table or json	table

Examples (config routes test)

# Test routing for a type
finfocus config routes test aws:ec2:Instance

# Include region in match context
finfocus config routes test aws:ec2:Instance us-east-1

# JSON output for scripts
finfocus config routes test aws:ec2:Instance --output json

plugin init

Initialize a new FinFocus plugin project.

Usage (plugin init)

finfocus plugin init <plugin-name> --author <name> --providers <list> [options]

Options (plugin init)

Flag	Description	Default
--author	Author name for the plugin	(required)
--providers	Comma-separated list of cloud providers	(required)
--help	Show help

Examples (plugin init)

# Initialize a new AWS plugin
finfocus plugin init my-aws-plugin --author "Your Name" --providers aws

plugin install

Install a FinFocus plugin from a registry or URL.

Usage (plugin install)

finfocus plugin install <plugin-name> [--version <version>] [--url <url>] [options]

Options (plugin install)

Flag	Description	Default
--version	Specify plugin version to install	latest
--url	URL to plugin binary (for custom installs)	(registry lookup)
--force	Force overwrite existing plugin installation	false
--clean	Remove all other versions after successful install	false
--metadata	Key=value metadata pairs (e.g., region=us-west-2)	(none)
--no-save	Don’t add plugin to config file	false
--help	Show help

Examples (plugin install)

# Install the latest Vantage plugin
finfocus plugin install vantage

# Install a specific version of a plugin
finfocus plugin install kubecost --version 0.2.0

# Install and remove all other versions (cleanup disk space)
finfocus plugin install kubecost --clean

# Install from a custom URL
finfocus plugin install my-plugin --url https://example.com/my-plugin-0.1.0.tar.gz

# Install with region metadata (selects region-specific binary)
finfocus plugin install aws-public --metadata="region=us-west-2"

plugin update

Update an installed FinFocus plugin.

Usage (plugin update)

finfocus plugin update <plugin-name> [options]

Options (plugin update)

Flag	Description	Default
--version	Specify target version (defaults to latest)	latest
--all	Update all installed plugins	false
--help	Show help

Examples (plugin update)

# Update the Vantage plugin to the latest version
finfocus plugin update vantage

# Update all installed plugins
finfocus plugin update --all

plugin remove

Remove an installed FinFocus plugin.

Usage (plugin remove)

finfocus plugin remove <plugin-name> [options]

Options (plugin remove)

Flag	Description	Default
--all	Remove all installed plugins	false
--help	Show help

Examples (plugin remove)

# Remove the Vantage plugin
finfocus plugin remove vantage

# Remove all installed plugins
finfocus plugin remove --all

plugin list

List installed plugins with optional capability details.

Usage (plugin list)

finfocus plugin list [options]

Options (plugin list)

Flag	Description	Default
--verbose	Show detailed plugin capabilities and providers	false
--help	Show help

Examples (plugin list)

# List all plugins
finfocus plugin list

# Output:
# NAME      VERSION   SPEC    PATH
# vantage   0.1.0     0.4.14  /Users/me/.finfocus/plugins/vantage/v0.1.0/finfocus-plugin-vantage
# kubecost  0.2.0     0.4.14  /Users/me/.finfocus/plugins/kubecost/v0.2.0/finfocus-plugin-kubecost

# List with detailed capabilities (routing-aware)
finfocus plugin list --verbose

# Output:
# NAME        VERSION  PROVIDERS    CAPABILITIES                 SPEC    PATH
# aws-public  1.0.0    [aws]        ProjectedCosts, ActualCosts  0.4.14  /Users/me/.finfocus/plugins/aws-public/v1.0.0/finfocus-plugin-aws-public
# aws-ce      1.0.0    [aws]        Recommendations, ActualCosts 0.4.14  /Users/me/.finfocus/plugins/aws-ce/v1.0.0/finfocus-plugin-aws-ce
# gcp-public  1.0.0    [gcp]        ProjectedCosts, ActualCosts  0.4.14  /Users/me/.finfocus/plugins/gcp-public/v1.0.0/finfocus-plugin-gcp-public
# eks-costs   0.5.0    [aws]        ProjectedCosts                 0.4.14  /Users/me/.finfocus/plugins/eks-costs/v0.5.0/finfocus-plugin-eks-costs

plugin inspect

Inspect a plugin’s capabilities and field mappings.

Usage (plugin inspect)

finfocus plugin inspect <plugin-name> <resource-type> [options]

Options (plugin inspect)

Flag	Description	Default
--version	Specify plugin version to inspect	latest
--json	Output in JSON format	false
--help	Show help

Examples (plugin inspect)

# Inspect field mappings for AWS EC2 Instance
finfocus plugin inspect aws-public aws:ec2/instance:Instance

# Output:
# Field Mappings:
# FIELD                STATUS     CONDITION
# -------------------- ---------- ------------------------------
# instanceType         MAPPED
# region               MAPPED
# tags                 IGNORED    Not used for pricing

# Inspect specific version
finfocus plugin inspect aws-public aws:ec2/instance:Instance --version v0.1.0

# Output as JSON
finfocus plugin inspect aws-public aws:ec2/instance:Instance --json

plugin validate

Validate plugin installations.

Usage (plugin validate)

finfocus plugin validate [options]

Options (plugin validate)

Flag	Description
--help	Show help

Examples (plugin validate)

# Validate all plugins
finfocus plugin validate

# Output:
# vantage (0.1.0): OK
# kubecost (0.2.0): OK

plugin conformance

Run conformance tests against a plugin binary to verify protocol compliance.

Usage (plugin conformance)

finfocus plugin conformance <plugin-path> [options]

Options (plugin conformance)

Flag	Description	Default
--mode	Communication mode: tcp, stdio	tcp
--verbosity	Output detail: quiet, normal, verbose, debug	normal
--output	Output format: table, json, junit	table
--output-file	Write output to file	stdout
--timeout	Global suite timeout	5m
--category	Filter by category (repeatable): protocol, error, performance, context	all
--filter	Regex filter for test names
--help	Show help

Examples (plugin conformance)

# Basic conformance check
finfocus plugin conformance ./plugins/aws-cost

# Verbose output with JSON
finfocus plugin conformance --verbosity verbose --output json ./plugins/aws-cost

# Filter to protocol tests only
finfocus plugin conformance --category protocol ./plugins/aws-cost

# JUnit XML for CI
finfocus plugin conformance --output junit --output-file report.xml ./plugins/aws-cost

# Use stdio mode
finfocus plugin conformance --mode stdio ./plugins/aws-cost

plugin certify

Run full certification tests and generate a certification report.

Usage (plugin certify)

finfocus plugin certify <plugin-path> [options]

Options (plugin certify)

Flag	Description	Default
-o, --output	Output file for certification report	stdout
--mode	Communication mode: tcp, stdio	tcp
--timeout	Global certification timeout	10m
--help	Show help

Certification Requirements

A plugin is certified if all conformance tests pass:

• All protocol tests (Name, GetProjectedCost, GetActualCost)
• All error handling tests
• All context/timeout tests
• All performance tests

Examples (plugin certify)

# Basic certification
finfocus plugin certify ./plugins/aws-cost

# Save report to file
finfocus plugin certify --output certification.md ./plugins/aws-cost

# Use stdio mode
finfocus plugin certify --mode stdio ./plugins/aws-cost

# Output:
# 🔍 Certifying plugin at ./plugins/aws-cost...
# Running conformance tests...
# ✅ CERTIFIED - Plugin passed all conformance tests

Certification Report

The command generates a markdown report containing:

• Plugin name and version
• Certification status (CERTIFIED or FAILED)
• Test summary (total, passed, failed, skipped)
• List of issues (if any failed)

analyzer serve

Starts the FinFocus analyzer gRPC server. This command is intended to be run by the Pulumi CLI as part of the pulumi preview workflow, typically configured in Pulumi.yaml.

Usage (analyzer serve)

finfocus analyzer serve [options]

Options (analyzer serve)

Flag	Description	Default
--logtostderr	Log messages to stderr rather than log files	false
--v	Log level for V-logging (verbose logging)	0
--pulumilogfile	Pulumi log file name (internal use)	(generated)
--help	Show help

Examples (analyzer serve)

# This command is typically not run directly by users.
# It's configured in Pulumi.yaml for zero-click cost estimation:
#
# plugins:
#   - path: finfocus
#     args: ["analyzer", "serve"]

analyzer install

Install the finfocus binary as a Pulumi Analyzer plugin. This replaces the manual process of creating the plugin directory, copying the binary, and setting permissions.

After installation, the binary on PATH is required for Pulumi to find it:

export PATH="${HOME}/.pulumi/plugins/analyzer-finfocus-v<version>:${PATH}"

Usage (analyzer install)

finfocus analyzer install [options]

Options (analyzer install)

Flag	Description	Default
--force	Overwrite existing installation	false
--target-dir	Override Pulumi plugin directory	~/.pulumi/plugins/

Examples (analyzer install)

# Install the analyzer
finfocus analyzer install

# Force reinstall after upgrading finfocus
finfocus analyzer install --force

# Install to a custom directory
finfocus analyzer install --target-dir /opt/pulumi/plugins

analyzer uninstall

Remove all installed versions of the finfocus Pulumi Analyzer plugin. All analyzer-finfocus-v* directories are deleted from the plugin directory.

Usage (analyzer uninstall)

finfocus analyzer uninstall [options]

Options (analyzer uninstall)

Flag	Description	Default
--target-dir	Override Pulumi plugin directory	~/.pulumi/plugins/

Examples (analyzer uninstall)

# Uninstall the analyzer
finfocus analyzer uninstall

# Uninstall from a custom directory
finfocus analyzer uninstall --target-dir /opt/pulumi/plugins

Global Options

finfocus [global options] command [command options]

Option	Description
--help	Show help
--version	Show version
--debug	Enable debug logging
--verbose	Enable verbose output
--no-color	Disable colored output
--plain	Enable plain text mode (no TUI)
--high-contrast	Enable high contrast mode
--skip-version-check	Skip plugin spec version compatibility check

Date Formats

Accepted Formats

# ISO 8601 (YYYY-MM-DD)
finfocus cost actual --from 2024-01-01

# RFC3339 (full timestamp)
finfocus cost actual --from 2024-01-01T00:00:00Z

# Relative (future)
finfocus cost actual --from "7 days ago"

Output Formats

Table (Default)

Human-readable table format:

RESOURCE    TYPE       MONTHLY   CURRENCY
Instance1   ec2        $7.50     USD
Bucket1     s3         $0.50     USD
──────────────────────────────
Total                  $8.00     USD

JSON

Machine-readable JSON format:

{
  "summary": { "totalMonthly": 8.0, "currency": "USD" },
  "resources": [{ "name": "Instance1", "type": "ec2", "cost": 7.5 }]
}

NDJSON

Newline-delimited JSON (one per line):

{"name":"Instance1","type":"ec2","cost":7.50}
{"name":"Bucket1","type":"s3","cost":0.50}

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid arguments

---

See User Guide for workflow examples.