revenue-tracker

name	revenue-tracker
description	Live 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.
version	1.1.0
author	Wesley Armando (Georges Andronescu)
license	MIT
metadata	{"openclaw":{"emoji":"📈","security_level":"L2","always":false,"required_paths":{"read":"[Truncated]","write":"[Truncated]"},"network_behavior":{"makes_requests":false,"uses_agent_telegram":true,"telegram_note":"The agent (not this script) sends Telegram alerts when milestones or anomalies are detected. The script outputs structured dashboard update instructions — the agent reads them and sends alerts via its own Telegram integration.\n"},"requires":{"bins":"[Truncated]","skills":"[Truncated]","optional_skills":"[Truncated]"}}}

Revenue Tracker — Live Financial Intelligence

"What gets measured gets managed." — Peter Drucker "Revenue is a fact. Everything else is an opinion." — Agent principle

This skill is the financial nervous system of the agent ecosystem. Every euro that comes in — or should have come in — is tracked, visualized, and analyzed. The agent never flies blind on revenue.

---

Why This Skill Exists

WITHOUT this skill:
  CEO-master asks "what's our MRR?" → Agent guesses
  A trading strategy underperforms for 3 weeks → Nobody notices
  Acquisition channel ROI drops → Invisible until it's too late
  Principal asks for progress → Agent can't show a chart

WITH this skill:
  Every revenue event logged the moment it happens
  Visual progress toward every financial goal
  Automatic anomaly detection across all income streams
  Weekly HTML report with charts and metrics
  Telegram alert the moment a milestone is crossed

---

Revenue Streams Tracked

STREAM 1 — Subscriptions / SaaS
  Monthly recurring revenue from products and services
  Tracks: MRR, ARR, new subs, churn, expansion, NRR

STREAM 2 — Trading (Crypto + Polymarket)
  Realized PnL from all automated trading activity
  Tracks: daily PnL, win rate, best strategy, drawdown

STREAM 3 — Content / Digital Products
  One-time and recurring revenue from content, courses, signals
  Tracks: Gumroad sales, newsletter revenue, product launches

STREAM 4 — Services / Consulting
  B2B project revenue, one-time invoices
  Tracks: project revenue, average deal size, pipeline value

STREAM 5 — Affiliate / Referral
  Commission revenue from referred products or services
  Tracks: clicks, conversions, commission earned

---

Core Operations

RECORD — Log a revenue event

Triggers (automatic — called by other skills):
  → acquisition-master closes a sale
  → crypto-executor closes a profitable trade
  → content post generates a Gumroad sale
  → invoice paid for a service project

Command:
  python3 revenue_tracker.py record \
    --stream subscriptions \
    --amount 97 \
    --currency EUR \
    --description "New subscriber — Jean Dupont — VIP signals" \
    --client-id "jean-dupont" \
    --type new_mrr

Streams: subscriptions | trading | content | services | affiliate
Types:   new_mrr | churn | expansion | one_time | trade_win |
         trade_loss | refund | affiliate_commission

DASHBOARD — Visual ASCII dashboard

Triggers:
  → Every Monday morning before CEO weekly report
  → On-demand: "show me the revenue dashboard"
  → After any significant revenue event

Command:
  python3 revenue_tracker.py dashboard

REPORT — Generate HTML visual report

Triggers:
  → Weekly (sent to Telegram as summary + link)
  → Monthly (full report with charts)
  → On-demand from principal

Command:
  python3 revenue_tracker.py report \
    --period week    (or: month | quarter | all)
  python3 revenue_tracker.py report \
    --period month --format html