ProfitCtl documentation
Start with a saved scenario.
Then make it your own.
ProfitCtl is an open-source command-line tool for comparing product costs and testing profitability assumptions. This guide takes you from setup to a useful first result.
1. Choose how to run it.
For a native binary, use the release installation guide. It covers version pinning, checksum verification, macOS and Linux installation, and Windows archives. Evaluator prereleases must be selected explicitly.
Release installation guide ↗To run the current source, install Git and Go, then use the commands below in your terminal.
Get the source on GitHub ↗git clone https://github.com/IntelIP/ProfitCtl
cd ProfitCtl
go run . compare examples/hybrid_steady_profit.yml examples/hybrid_profit.ymlNative CLI startup needs no provider key. Paid assessment features use separate provider configuration.
2. Read the decision, not just the revenue.
The saved examples compare a steady-state contract with a pilot contract. These are synthetic fixtures, so their numbers illustrate the model.
The pilot example books more revenue, while the steady-state example has the higher operating margin and lower cost per user. This shows why an up-front payment and sustainable recurring economics are different questions.
The comparison output includes revenue, recurring revenue, fees, booked and operating margins, cost per user, covenant results, and the leaders for each metric.
3. Replace the assumptions.
A scenario is a YAML file containing the business inputs you want to test.
- Costs: fixed and variable costs, including infrastructure, model calls, tools, and payment fees.
- Pricing: subscriptions, usage pricing, plan mixes, or contract terms.
- Usage: users, growth, and simulation inputs.
- Targets: the margin and cost limits that define an acceptable outcome.
- Evidence: sources, capture dates, confidence, and notes for your cost assumptions.
profitctl simulate -f your-scenario.yml
profitctl compare baseline.yml candidate.yml
profitctl validate -f your-scenario.ymlUse the installed CLI for these commands. The equivalent source invocation begins with go run ..
4. Know what the website demo shows.
The guided terminal runs the real ProfitCTL CLI in your browser. It validates a fictional scenario, simulates a baseline, shows a margin failure as usage grows, and compares a cheaper request route. The story repeats automatically. Select a step to hold its result. With reduced motion enabled, the demo shows a single comparison without looping.
The demo uses bundled, read-only scenario files and made-up rates. It does not call AI providers, fetch live prices, or give access to your local files. Download a scenario to inspect its inputs or run the same commands with the installed CLI.
The separate cost calculator is a simplified gross-margin illustration. Your CLI scenarios can include payment fees, contract effects, cost provenance, and simulation settings. Check assumptions against your own usage and rates before relying on an estimate.
The local CLI, Codex skill, and CI output are available today. Hosted team workspaces and approvals are planned.