rshade 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