Finfocus install
FinOps CLI for Pulumi — projected costs, actual spend tracking, budget enforcement, and cost optimization for cloud infrastructure
npx -y skills add rshade/finfocus --skill finfocus-installAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Automated FinFocus CLI and plugin setup workflow. Use when installing finfocus, setting up plugins for cloud providers, initializing configuration, bootstrapping a new finfocus environment, or onboarding a project for cost analysis. Triggers on: "install finfocus", "setup finfocus", "configure cost analysis", "install plugins", "bootstrap finfocus", "finfocus setup", "add cost tracking", "onboard project", or any task involving initial finfocus installation and environment configuration.
SKILL.md
4.5 KB, as published. Nobody here has run it
FinFocus Installation
Quick Path: Existing Install
If finfocus is already installed, prefer the built-in setup command:
finfocus setup # Full bootstrap (idempotent)
finfocus setup --skip-analyzer # Without Pulumi analyzer
finfocus setup --skip-plugins # Without plugins (offline)
finfocus setup --non-interactive # CI/CD mode
Setup runs: version check, Pulumi detection, directory creation, config init,
analyzer install, and default plugin (aws-public) install.
Full Workflow
Step 1: Check Existing Installation
finfocus --version
If installed, skip to Step 3. If not, continue.
Step 2: Install the CLI Binary
Install script (Linux/macOS):
curl -fsSL https://raw.githubusercontent.com/rshade/finfocus/main/scripts/install.sh | sh
| Env Var | Purpose |
|---|---|
FINFOCUS_VERSION | Pin specific version (default: latest) |
FINFOCUS_INSTALL_DIR | Custom install dir (default: /usr/local/bin or ~/.local/bin) |
FINFOCUS_NO_VERIFY=1 | Skip SHA256 checksum verification |
Go install (fallback/Windows):
go install github.com/rshade/finfocus/cmd/finfocus@latest
Source build (last resort):
git clone https://github.com/rshade/finfocus.git && cd finfocus && make build
Verify: finfocus --version
Step 3: Detect Cloud Providers
Determine which plugins to install:
- Check for
Pulumi.yaml/Pulumi.yml— scan resource type prefixes (aws:,kubernetes:) - Check Pulumi state (
pulumi stack export) for resource types - Check filesystem:
~/.aws/,~/.config/gcloud/,~/.azure/, kubeconfig - Default to
aws-publicif nothing detected
Provider-to-plugin mapping — see references/registry-plugins.md.
Step 4: Install Plugins
finfocus plugin install aws-public
finfocus plugin install kubecost
Key flags — see references/install-commands.md for the complete flag reference.
# Region-specific AWS pricing
finfocus plugin install aws-public --metadata="region=us-east-1"
# CI: auto-fallback if version lacks platform assets
finfocus plugin install aws-public --fallback-to-latest
# Reinstall + clean old versions
finfocus plugin install aws-public --force --clean
Step 5: Initialize Configuration
# Inside a Pulumi project → project-local config
finfocus config init
# Creates: $PROJECT/.finfocus/config.yaml + .gitignore
# Global config
finfocus config init --global
# Creates: ~/.finfocus/config.yaml
Config precedence: project-local > global > env vars > defaults.
Step 6: Install Pulumi Analyzer (Optional)
For inline cost estimates during pulumi preview:
finfocus analyzer install
finfocus analyzer check # Verify setup
Then run: pulumi preview --policy-pack ~/.finfocus/analyzer
Add to PATH for discovery: export PATH="$HOME/.finfocus/analyzer:$PATH"
Step 7: Validate
finfocus plugin validate # Check all plugin binaries
finfocus plugin list --verbose # Confirm installed plugins
finfocus plugin list --available # Show registry plugins
Directory Structure
~/.finfocus/
├── config.yaml # Global configuration
├── plugins/ # Plugin binaries
│ ├── aws-public/<version>/finfocus-plugin-aws-public
│ └── kubecost/<version>/finfocus-plugin-kubecost
├── cache/ # BoltDB cache (cache.db)
├── logs/ # Log files
└── analyzer/ # Pulumi policy pack
References
- references/install-commands.md — Complete CLI flag reference for install, setup, config, and plugin commands
- references/registry-plugins.md — Available plugins, provider mappings, and capability matrix