LeoYeAI/agent-master-skills / skills/agent-revenue-tracker
revenue-tracker
VerifiedLive revenue tracking system for autonomous agents. Tracks MRR, assets, trades, acquisition channels, and learning metrics in real time. Generates visual ASCII dashboards, progress charts, and an auto-refreshing HTML dashboard. After every revenue event, outputs structured instructions for the agent to update Google Sheets (via gog), Notion (via virtual-desktop), or falls back to local HTML. The agent sends Telegram alerts on milestones and anomalies via its own Telegram integration. Use when the agent needs to record revenue events, track progress toward financial goals, generate visual reports, or monitor all income streams simultaneously.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 5.5 KB |
| SKILL.md | skill md | 16.5 KB |
| _meta.json | config | 294 B |
| revenue_tracker.py | script | 46.4 KB |
README.md
View on GitHub# revenue-tracker
π **Live revenue intelligence for autonomous agents.**
Every euro tracked. Every stream visualized. Every milestone celebrated.
Every anomaly caught before it becomes a problem.
**v1.1.0** β Auto-updating dashboard: Google Sheets β Notion β HTML fallback.
---
## What It Does
- **5 revenue streams**: subscriptions, trading, content, services, affiliate
- **ASCII dashboard**: visual MRR trend, stream breakdown, goal progress bars
- **Auto-updating HTML dashboard**: dark-mode, auto-refresh 60s β generated after every event
- **Google Sheets sync**: after every event, agent updates "Veritas Revenue Tracker" sheet
- **Notion fallback**: if Sheets unavailable, agent updates Notion database
- **HTML local fallback**: always generated by the script, zero external dependencies
- **Milestone alerts**: agent sends Telegram alert on every milestone crossed
- **Anomaly detection**: churn spikes, revenue gaps, negative MRR
- **Learning log**: revenue intelligence that compounds over time
- **Asset tracker**: trading capital, tools, anything of value
- **Goal system**: set MRR targets with deadlines and track progress
---
## Auto-Dashboard Update Flow
After **every** `record` command, the script:
```
1. Generates /workspace/revenue/reports/dashboard.html β always
2. Outputs structured instructions β agent executes:
Priority 1 β Google Sheets (via wesley-web-operator / gog)
Priority 2 β Notion (via virtual-desktop)
Priority 3 β HTML local (already done by script)
```
**Google Sheets structure** (agent creates on first use):
| Tab | Content |
|---|---|
| `Events` | Date, Stream, Type, Amount, Description, MRR after |
| `Dashboard` | MRR, ARR, Total, Customers, Phase β live cells |
| `By Stream` | MRR per stream + % share |
| `Goals` | Target, Current, % progress, Deadline, Est. weeks |
---
## Quick Start
```bash
# Initialize
python3 revenue_tracker.py --init
# Record a sale (auto-updates all dashboards)
python3 revenue_tracker.py record \
--stream subscriptions --amount 97 --type new_mrr \
--description "New VIP subscriber"
# Visual ASCII dashboard
python3 revenue_tracker.py dashboard
# Weekly HTML report
python3 revenue_tracker.py report --period week --format html
# Set a goal
python3 revenue_tracker.py goal \
--set "mrr_10k" --target 10000 --deadline "2026-09-30"
# Log a learning
python3 revenue_tracker.py learn \
--category acquisition --insight "CTOs reply 14% to signal-based emails" \
--impact high
# Check anomalies
python3 revenue_tracker.py anomalies
```
---
## Dashboard Preview
```
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π REVENUE DASHBOARD β 2026-03-16 β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ£
β MRR β¬4,200 β² +35.5% ARR β¬50,400 β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ£
β β¬10K MRR ββββββββββββββββββββ 42.0% ~21w left β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ£
β Subscriptions ββββββββββββββββββββ β¬3,200 76% β
β Trading ββββββββββββββββββββ β¬650 15% β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ£
β MRR Trend: βββββ
βββ (β¬1,200 β β¬4,200) β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
```
---
## Milestone Alerts
Agent sends Telegram alert every time a milestone is crossed:
- First β¬1 Β· β¬100 MRR Β· β¬1K Β· β¬5K Β· β¬10K Β· β¬50K MRR
- First customer Β· 10 customers Β· 100 customers
---
## Files
| File | Role |
|---|---|
| `SKILL.md` | Full documentation β both engines |
| `README.md` | This file |
| `scripts/revenue_tracker.py` | CLI β record, dashboard, report, goals, assets, anomalies |
---
## Requires (optional but recommended)
- **wesley-web-operator** β Google Sheets auto-sync via gog
- **virtual-desktop** β Notion fallback sync
---
## Works Best Combined With
- **ceo-master** β reads dashboard for weekly report
- **acquisition-master** β auto-records subscription revenue
- **crypto-executor** β auto-records trade PnL
- **agent-memory-manager** β links revenue to client records
- **funnel-revenue-engine** β funnel events feed directly into tracker
---
## Changelog
### v1.1.0
- Auto-update HTML dashboard after every revenue event
- Google Sheets sync instructions output (via wesley-web-operator)
- Notion fallback instructions output (via virtual-desktop)
- `optional_skills` declared in metadata
- Metadata fully consistent with script capabilities
- Fixed: path references corrected (revenue_tracker.py at bundle root)
### v1.0.0
- Initial release
---
## Author
Wesley Armando (Georges Andronescu)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself β your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |