finfocus-analyzer-setup
Install and configure FinFocus as a Pulumi Analyzer for inline cost estimation during pulumi preview. Use when setting up the analyzer, configuring the policy pack, debugging analyzer issues, or enabling zero-click cost estimates in Pulumi workflows. Triggers on: "set up analyzer
Install
npx skills add https://github.com/rshade/finfocus/tree/main/agent-skills/finfocus-analyzer-setup
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install rshade-finfocus@llmmart
git clone https://github.com/rshade/finfocus.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole rshade/finfocus collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
FinFocus Analyzer Setup
Inline cost estimation during pulumi preview via the Pulumi Analyzer protocol.
All diagnostics are ADVISORY — never blocks deployments.
Prerequisites
finfocus --version # FinFocus CLI installed
pulumi version # Pulumi CLI installed
finfocus plugin list # At least one cost plugin installed
Quick Setup
finfocus analyzer install # Install + create policy pack
finfocus analyzer check # Verify all 4 checks pass
# Add to PATH (required for Pulumi to discover the binary)
export PATH="$HOME/.finfocus/analyzer:$PATH"
# Run preview with costs
pulumi preview --policy-pack ~/.finfocus/analyzer
For persistent PATH, add the export to ~/.bashrc or ~/.zshrc.
Windows (PowerShell): Add to your PowerShell profile ($PROFILE):
$env:PATH = "$env:USERPROFILE\.finfocus\analyzer;$env:PATH"
Restart PowerShell for changes to take effect.
What analyzer install Does
- Creates
~/.pulumi/plugins/analyzer-finfocus-v{VERSION}/pulumi-analyzer-finfocus(symlink on Unix, copy on Windows) - Creates
~/.finfocus/analyzer/PulumiPolicy.yaml(runtime: finfocus) - Creates
~/.finfocus/analyzer/pulumi-analyzer-policy-finfocus(Pulumi before 3.270.0) - Creates
~/.finfocus/analyzer/pulumi-language-finfocus(Pulumi 3.270.0 and later)
On Windows both pack entries end in .exe. Running finfocus analyzer install
again adds pulumi-language-finfocus to a pack that has only the older entry.
Use --force to reinstall after upgrading finfocus. Use --target-dir to
override the Pulumi plugin directory.
Verification
finfocus analyzer check # Table output
finfocus analyzer check --output json # JSON for CI
Runs 4 sequential checks (later checks skip if earlier ones fail):
| Check | Verifies |
|---|---|
policy_pack_dir |
~/.finfocus/analyzer/ exists |
pulumi_policy_yaml |
PulumiPolicy.yaml has runtime: finfocus |
binary_in_path |
pulumi-analyzer-policy-finfocus on PATH |
grpc_smoke_test |
analyzer serve starts and responds to RPC |
Expected Output
Policies:
finfocus@v0.3.3 (local: ~/.finfocus/analyzer)
- [advisory] cost-estimate (aws:ec2/instance:Instance: my-instance)
Estimated Monthly Cost: $7.50 USD (source: finfocus-plugin-aws)
- [advisory] stack-cost-summary (pulumi:pulumi:Stack: my-stack)
Total Estimated Monthly Cost: $7.50 USD (1 resources analyzed)
CI/CD Usage
export PULUMI_POLICY_PACK_PATH="$HOME/.finfocus/analyzer"
pulumi preview # No --policy-pack flag needed
Troubleshooting
See references/troubleshooting.md for common failure modes, PATH issues, version mismatches, plugin isolation, and config tuning.
Uninstall
finfocus analyzer uninstall # Remove from Pulumi plugin dir
finfocus analyzer uninstall --target-dir /custom/path
Files (finfocus)
-
references
-
troubleshooting.md 4.2 KB
Loading…
-
-
finfocus-analyzer-setup.skill 3.7 KB · in bundle
-
SKILL.md 3.7 KB
--- name: finfocus-analyzer-setup description: > Install and configure FinFocus as a Pulumi Analyzer for inline cost estimation during pulumi preview. Use when setting up the analyzer, configuring the policy pack, debugging analyzer issues, or enabling zero-click cost estimates in Pulumi workflows. Triggers on: "set up analyzer", "configure analyzer", "install analyzer", "Pulumi preview costs", "inline cost estimates", "policy pack setup", "analyzer integration", "zero-click cost estimation", "analyzer check", or any task involving finfocus Pulumi Analyzer configuration. --- <!-- Copyright 2025-2026 Richard Shade. Licensed under Apache-2.0. --> <!-- SPDX-License-Identifier: Apache-2.0 --> # FinFocus Analyzer Setup Inline cost estimation during `pulumi preview` via the Pulumi Analyzer protocol. All diagnostics are ADVISORY — never blocks deployments. ## Prerequisites ```bash finfocus --version # FinFocus CLI installed pulumi version # Pulumi CLI installed finfocus plugin list # At least one cost plugin installed ``` ## Quick Setup ```bash finfocus analyzer install # Install + create policy pack finfocus analyzer check # Verify all 4 checks pass # Add to PATH (required for Pulumi to discover the binary) export PATH="$HOME/.finfocus/analyzer:$PATH" # Run preview with costs pulumi preview --policy-pack ~/.finfocus/analyzer ``` For persistent PATH, add the export to `~/.bashrc` or `~/.zshrc`. **Windows (PowerShell):** Add to your PowerShell profile (`$PROFILE`): ```powershell $env:PATH = "$env:USERPROFILE\.finfocus\analyzer;$env:PATH" ``` Restart PowerShell for changes to take effect. ## What `analyzer install` Does 1. Creates `~/.pulumi/plugins/analyzer-finfocus-v{VERSION}/pulumi-analyzer-finfocus` (symlink on Unix, copy on Windows) 2. Creates `~/.finfocus/analyzer/PulumiPolicy.yaml` (runtime: finfocus) 3. Creates `~/.finfocus/analyzer/pulumi-analyzer-policy-finfocus` (Pulumi before 3.270.0) 4. Creates `~/.finfocus/analyzer/pulumi-language-finfocus` (Pulumi 3.270.0 and later) On Windows both pack entries end in `.exe`. Running `finfocus analyzer install` again adds `pulumi-language-finfocus` to a pack that has only the older entry. Use `--force` to reinstall after upgrading finfocus. Use `--target-dir` to override the Pulumi plugin directory. ## Verification ```bash finfocus analyzer check # Table output finfocus analyzer check --output json # JSON for CI ``` Runs 4 sequential checks (later checks skip if earlier ones fail): | Check | Verifies | |-------|----------| | `policy_pack_dir` | `~/.finfocus/analyzer/` exists | | `pulumi_policy_yaml` | `PulumiPolicy.yaml` has `runtime: finfocus` | | `binary_in_path` | `pulumi-analyzer-policy-finfocus` on PATH | | `grpc_smoke_test` | `analyzer serve` starts and responds to RPC | ## Expected Output ```text Policies: finfocus@v0.3.3 (local: ~/.finfocus/analyzer) - [advisory] cost-estimate (aws:ec2/instance:Instance: my-instance) Estimated Monthly Cost: $7.50 USD (source: finfocus-plugin-aws) - [advisory] stack-cost-summary (pulumi:pulumi:Stack: my-stack) Total Estimated Monthly Cost: $7.50 USD (1 resources analyzed) ``` ## CI/CD Usage ```bash export PULUMI_POLICY_PACK_PATH="$HOME/.finfocus/analyzer" pulumi preview # No --policy-pack flag needed ``` ## Troubleshooting See [references/troubleshooting.md](references/troubleshooting.md) for common failure modes, PATH issues, version mismatches, plugin isolation, and config tuning. ## Uninstall ```bash finfocus analyzer uninstall # Remove from Pulumi plugin dir finfocus analyzer uninstall --target-dir /custom/path ```
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.