Claude Code Handoff — EdgeClaw VPS

Last updated: 2026-04-01 For: New Claude Code instances connecting to the Oracle VPS

Quick Start

# SSH into the VPS
ssh -i ~/.ssh/oracle_key.pem ubuntu@64.181.198.130

# Start Claude Code
cd /home/ubuntu/edgeclaw
claude

Everything you need (CLAUDE.md, memory, MCP config, settings) is already on the server. Just SSH in and run claude.

Server Access

Field	Value
Host	`64.181.198.130`
User	`ubuntu`
Auth	SSH key (`~/.ssh/oracle_key.pem` on your PC)
OS	Ubuntu 22.04 ARM/aarch64
Specs	4 OCPUs, 23GB RAM, 194GB disk
No sudo	Password was never set (SSH key only)

What Lives Here

EdgeClaw (`/home/ubuntu/edgeclaw/`)

The main project. TypeScript + Hono server running on port 8080. Caddy reverse proxy on 443 (domain: edge-assist.duckdns.org).

Key commands:

Restart: systemctl --user restart edgeclaw
Status: systemctl --user status edgeclaw
Logs: journalctl --user -u edgeclaw --no-pager -n 50
Health: curl -s http://localhost:8080/health | python3 -m json.tool
Dashboard: http://localhost:8080/data-status

What EdgeClaw Does

AI chat assistant for the boss via Telegram (@Edge_Assistant_Bot)
Sports edge detection — scans Kalshi markets vs FanDuel/Pinnacle/DraftKings fair values
19 trading desks — sports, weather, crypto, forex, etc. (see DESK-MASTER-SHEET.md)
Data pipeline — 50+ scrapers, cron jobs, SQLite databases
Council system — 5-model panel (Opus, Sonnet, Gemini, Grok, gpt-oss) for major decisions

Databases

All SQLite, stored in /home/ubuntu/edgeclaw/data/db/:

research-pipeline.db — main data (sports odds, player props, weather, etc.)
edge-scanner.db — game edge detection results
prop-edge-nba-*.db — player prop edges (one DB per stat: points, rebounds, assists, threes, blocks, steals)
memory-tiered.db — EdgeClaw's tiered memory system
audit.db — API cost tracking
health.db — server health metrics
tasks.db — user task queue

Other Services on This Server

Telegram Bot Bridges (all systemd user services)

Bot	Service	Purpose
@Claude2107Bot	`claude-bridge`	Boss talks to Claude Code via Telegram
@EdgeTechSupportBot	`claude-techsupport`	Claude tech support channel
@GGAnalystBot	`gemini-bridge`	Gemini analyst
@GGTechSupportBot	`gemini-techsupport`	Gemini tech support
@ClaudeAnalystBot	`claude-analyst`	Claude analyst

All run as systemctl --user services. Do NOT interfere with them.

Discord Bots

5 Discord bots (edge, techsupport, analyst for both Claude and Gemini). Same systemctl --user pattern.

EcoCell (`/home/ubuntu/ecocell/`)

Phone resale business platform on port 3100. Has its own MCP server at /home/ubuntu/ecocell-mcp/.

VidStrip (`/home/ubuntu/vidstrip/`)

Video metadata stripping app on port 3000.

Boss Communication Rules

Boss is NOT a developer. Explain everything in plain language. No jargon.
NO CODING WITHOUT PERMISSION. Discuss approach first, code only when told.
Short answers. He reads on iPhone (Termius) — can't scroll well.
He uses Telegram to talk to EdgeClaw, and Termius/Telegram bridges to talk to you.

Current Work (as of 2026-04-01)

Player Prop Edge Scanner — Just Fixed

Scanner: src/pipeline/data/scrapers/prop-edge-scanner.ts
Name matcher: src/pipeline/data/scrapers/player-name-match.ts
Fixed game/team validation — scanner now checks that Kalshi ticker teams match FanDuel game teams
Fixed view to show all props (not just Over-side-best rows)
6 separate DBs: prop-edge-nba-{points,rebounds,assists,threes,blocks,steals}.db

Edge Scanner Display Pages

Code: src/pipeline/data-status.ts (massive file, ~5400 lines)
Display spec: docs/edge-scanner-display-spec.md
Date filter defaults to today (ET timezone), "Show All" shows last 50
Analytics: calibration tables, win rate by edge size, confidence breakdown, CLV
Props skip "YES vs NO Performance" table (over-only market)
Props CLV uses FanDuel closing odds, games use Pinnacle closing prob

Council System

5-advisor panel with anonymous peer review
Full spec: docs/council-spec.md
Latest ruling: data/councils/2026-04-01/orderbook-confidence/ruling.txt
Key finding: Kalshi order books genuinely thin (JIT market makers), not broken
Approved 4-signal confidence system (spread, recency, consensus, velocity)

Pending Items

PostgreSQL — needs sudo to install, sudo requires password that was never set. On hold.
4-signal confidence — approved by council, not yet implemented
MLB prop edges — use different table structure (mlb_prop_edges), need separate handling

Key Files Reference

File	Purpose
`CLAUDE.md`	Auto-loaded by Claude Code — all project context
`DESK-MASTER-SHEET.md`	All 19 desks, their status, models, schedules
`src/pipeline/data-status.ts`	Dashboard + all data viewer pages (~5400 lines)
`src/pipeline/data/scrapers/prop-edge-scanner.ts`	Player prop edge scanner
`src/pipeline/data/scrapers/player-name-match.ts`	FanDuel↔Kalshi player matching
`src/pipeline/sports/edge-scanner.ts`	Game totals/spreads edge scanner
`src/core/agent.ts`	Main EdgeClaw AI agent
`src/core/council.ts`	Council system
`src/config.ts`	All env config
`docs/council-spec.md`	Council process spec
`docs/edge-scanner-display-spec.md`	Edge page display spec

API Keys (all in `.env` on the server)

Service	Key Location
xAI/Grok	`.env` → `XAI_API_KEY`
The Odds API	`.env` → `ODDS_API_KEY`
Kalshi	`.env` → `KALSHI_API_KEY_ID` + RSA key
Groq (free Whisper)	`.env` → `GROQ_API_KEY`
Gemini	Cloudflare proxy (Oracle geo-blocks Google)
Claude/Anthropic	Subscription (not API)

Memory System

Claude Code memory: /home/ubuntu/.claude/projects/-home-ubuntu/memory/

MEMORY.md — index file (auto-loaded, keep under 200 lines)
panel-rules.md — council system spec
Various topic files

EdgeClaw memory: data/db/memory-tiered.db (separate system, don't touch)

Shared Folder (`/home/ubuntu/shared/`)

Drop zone between EdgeClaw and Claude Code:

proposals/ — EdgeClaw code proposals for review
reports/ — diagnostics, spend reports
EdgeClaw writes, Claude Code reads. One-way.

Startup Checklist

Every new session, immediately:

ls /home/ubuntu/shared/proposals/ — check for pending proposals
Read CLAUDE.md if context is needed
Check memory files if the boss references prior work

Source: ~/edgeclaw/docs/claude-code-handoff.md