Reading the repo
Reading the repo
Fresh setup, read just now
Will it work on Linux?
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
git clone https://github.com/shepdogg6t7-glitch/costwatchdog-python.git cd costwatchdog-python
Python >=3.10
sudo apt install python3 python3.10 python3-venv # Debian/Ubuntu
python -m venv .venv source .venv/bin/activate pip install -e .
The repository ships a fixture subscription (14 resources, a 3-day cost export, a metrics dump) so the whole pipeline runs offline.
# 1. audit the fixtures and write a report + an executable plan
PYTHONPATH=src python3 -m costwatchdog.cli audit \
--cost-csv examples/cost-export.csv \
--inventory examples/inventory.json \
--metrics examples/metrics.json \
--policy examples/policy.json \
--today 2026-10-27 \
--format both --out reports/report.md --plan-out reports/plan.json
# 2. read reports/report.md, then dry-run the plan (this executes nothing)
PYTHONPATH=src python3 -m costwatchdog.cli apply --plan reports/plan.json
audit is read-only everywhere: even in live mode it never changes anything.
The fixture audit finds five things it would do now, one that needs a human, and three it only reports — including a VM protected by tag, a resource group on the deny list, and a $70/month VM with no telemetry that it deliberately refuses to guess about.
Exit codes: 0 fine, 2 usage/configuration problem, 3 waste budget exceeded,
4 an action failed. --fail-on-waste turns the audit into a CI gate.
No reports for Linux yet.
Opens a chat with this manual already filled in, for Linux. It uses your own account; gitmanual sends nothing.