Your personal AI CFO — she lives on your desktop, watches your money, and fights for every dollar.
What is Fox • Features • How it Works • Getting Started • Architecture • Roadmap
Fox is an AI financial assistant that sits on your macOS desktop as a 3D companion.
Most finance tools give you dashboards, charts, and spreadsheets. Fox gives you a character who actually manages your money — she talks to you, makes recommendations, and takes action on your behalf.
She does three things:
- Trades for you — executes stocks and crypto trades on Polymarket and US brokerages, so you don't have to stare at charts all day
- Kills waste — monitors your email for subscription charges, analyzes which ones you actually use, and cancels the rest through browser automation
- Talks to you — not another app you forget to open. She's always on your desktop, ready to chat about your finances or anything else
Every action that touches your money requires your explicit approval. She'll show you exactly what she's about to do, take a screenshot, and wait for you to say "yes" before proceeding.
Fox lives on your macOS desktop as a 3D character rendered in SceneKit. She floats transparently over your workspace — only she intercepts clicks, everything else passes through to your apps.
| Gesture Control | Drag to reposition, pinch to zoom, two-finger scroll to rotate 360° |
| AI Chat | Double-click to open a chat terminal powered by Claude Code. She has her own personality, memory, and opinions about your spending habits |
| Slap Reaction | Physically slap your MacBook and she reacts with anime voice effects and comic speech bubbles (Apple Silicon accelerometer via IOKit HID) |
| Persona System | Her identity, personality, and preferences are editable markdown files. Customize who she is and how she talks |
Fox trades on your behalf across prediction markets and stock brokerages. She uses Claude's Computer Use to navigate trading platforms in a real browser — the same way you would, but faster.
| Polymarket | Browse prediction markets, analyze odds and volume, place bets on outcomes. She reads the market page, recommends a position, and sets up the trade for your confirmation |
| US Stocks | Search tickers, view stock details, place buy/sell orders through your brokerage (Robinhood, Schwab, etc.) |
| Smart Execution | She picks entries, sets stops, and manages positions based on current market context |
| Daily Briefing | A quick morning summary of what happened overnight, your positions, and what she's planning next |
| Always Asks First | No trade goes through without your explicit "yes". She shows a screenshot of the order before every execution |
Fox monitors your email for subscription charges and helps you cancel the ones you don't need. She connects to your inbox via AgentMail and uses browser automation to handle cancellation flows end-to-end.
| Email Monitoring | Forward subscription emails to undercurrent-agent@agentmail.to — Fox parses them with Claude, extracting service name, price, billing cycle, renewal date, and usage signals |
| Smart Analysis | For each subscription, she recommends cancel / keep / review with a one-line reason. She considers usage frequency, cost, and cheaper alternatives |
| Browser Automation | When you cancel, Fox opens the cancellation page and navigates the flow step by step — filling forms, clicking through retention offers, handling multi-step dark patterns |
| Payment Management | Need to update your card on file? Fox fills in payment info on subscription pages via browser automation |
| Human in the Loop | Every destructive action requires your explicit approval. She screenshots, describes what she's about to do, and waits for confirmation |
Fox combines two systems that talk to each other through Claude Code CLI:
| Desktop Companion | Financial Agent | |
|---|---|---|
| Language | Swift | Python |
| What it does | Renders 3D character, handles gestures, runs chat terminal | Reads emails, analyzes subscriptions, executes trades, controls browser |
| AI | Claude Code CLI (chat + personality) | Claude API (tool-use loop + Computer Use) |
| Key tech | SceneKit, AppKit, IOKit HID, AVFoundation | AgentMail, screencapture, cliclick |
| Role | The face | The brain |
Flow: You double-click Fox → chat terminal opens → you ask her to do something → Claude Code dispatches to the Python agent → agent takes action on your screen → Fox reports back.
- macOS 14.0+ (Sonoma or later)
- Apple Silicon (M1/M2/M3/M4) — required for slap detection
- Xcode Command Line Tools
xcode-select --installFor AI chat:
curl -fsSL https://claude.ai/install.sh | sh
claude /loginFor spending management:
pip install -r requirements.txt
playwright install chromiumgit clone https://github.com/troyrocket/fox.git
cd fox/desktop-girl# Main app
swiftc -framework AppKit -framework SceneKit -framework Foundation \
-framework IOKit -framework AVFoundation \
-o desktop-girl main.swift Config.swift ShellEnvironment.swift \
ClaudeSession.swift KeyableWindow.swift TerminalView.swift \
PetSCNView.swift AppDelegate.swift SlapDetector.swift ComicBubbleView.swift
# Accelerometer helper (for slap detection)
swiftc -framework Foundation -framework IOKit -o accel-helper accel-helper.swiftThe accelerometer requires root privileges. Run this once:
sudo chown root accel-helper && sudo chmod 4755 accel-helper./desktop-girl ./model/foxgirl_new.usdzA 3D fox girl appears on your desktop. Double-click her to start chatting.
| Feature | Status |
|---|---|
| 3D companion on desktop | ✅ |
| Drag, zoom, rotate gestures | ✅ |
| AI chat with personality & memory | ✅ |
| Slap → scream + speech bubble | ✅ |
| Subscription email parsing | ✅ |
| Cancel/Keep/Review recommendations | ✅ |
| Browser automation for cancellations | ✅ |
| Polymarket trading | ✅ |
| US stock trading | ✅ |
| Portfolio management | 🔜 |
| Daily market briefing | 🔜 |
| Action | Input |
|---|---|
| Move | Drag the model |
| Rotate | Click model, then two-finger scroll |
| Zoom | Click model, then pinch |
| Chat | Double-click the model |
| Close chat | Esc or click outside |
| Slap | Physically slap your MacBook |
desktop-girl/ — 3D companion app (Swift / macOS native)
├── main.swift Entry point
├── AppDelegate.swift Window, scene, events, slap reaction
├── PetSCNView.swift 3D rendering, gestures, click detection
├── TerminalView.swift Chat UI with markdown rendering
├── ClaudeSession.swift Claude Code CLI process management
├── SlapDetector.swift Accelerometer via IOKit HID
├── ComicBubbleView.swift Comic-style speech bubbles
├── persona/ Her personality (editable .md files)
│ ├── identity.md Who she is
│ ├── personality.md How she behaves
│ ├── preferences.md What she likes and dislikes
│ └── memory.md What she remembers
├── sounds/ Voice effects (slap reactions, notifications)
└── model/ 3D model (.usdz)
src/ — Financial agent backend (Python)
├── agent_brain.py Claude Computer Use agent loop
├── computer_use.py Screenshot + mouse/keyboard control (macOS)
├── trading/
│ ├── polymarket.py Polymarket: browse, trade, portfolio
│ └── stocks.py US stocks: search, order, portfolio
└── spending/
├── email_monitor.py AgentMail inbox reader
├── email_parser.py Claude-powered subscription parsing
└── subscription_manager.py Browser automation for cancellations
| Layer | Technology |
|---|---|
| 3D Rendering | SceneKit (macOS native) |
| Desktop App | Swift + AppKit |
| AI Chat | Claude Code CLI (stream-json) |
| Financial Agent | Claude API + Computer Use |
| Email Parsing | AgentMail + Claude Haiku |
| Browser Control | screencapture + cliclick (macOS native) |
| Slap Detection | Apple Silicon accelerometer (IOKit HID) |
- 3D desktop companion with gesture controls
- AI chat with personality and memory
- Slap detection with anime voice reactions
- Subscription email monitoring and parsing
- Cancel/Keep/Review recommendation system
- Browser automation for cancellation flows
- Polymarket prediction market trading
- US stock trading via brokerage
- Portfolio dashboard and tracking
- Daily market briefing
- Payment method auto-fill
- Custom character models
- iOS companion app
MIT