Local-first operator console: fuses your AI agent sessions (Claude Code, Codex CLI, ChatGPT), git repos, and markdown notes into one dashboard that tells you what to do next.
Project description
⚡ opsroom
Your AI agents write code all day. opsroom shows you whether any of it pays.
One console for every AI coding agent you run — Claude Code, OpenAI Codex CLI, ChatGPT, Claude web — plus your git repos and your markdown notes (Obsidian or plain folders), fused into one local dashboard that answers the only question that matters:
What should I do right now to make money?
No cloud. No accounts. No dependencies. One Python package, one SQLite file on your disk, one HTML file as your console.
pipx install opsroom-console # or: pip install opsroom-console / uv tool install opsroom-console
opsroom demo # see a fully loaded console in 10 seconds (fictional data)
opsroom init # wire up YOUR repos, goal, and notes
opsroom sync && opsroom dash
What you get
🎯 NOW — an action queue, not a report. Drafts staged in your outreach tracker become a send list with an open-your-drafts button. Phone-first targets become tap-to-dial links. Stale leads become a rescue block. The single highest cash action sits on top, pulled from your own dashboard note.
🏢 VENTURES — every project, with a brief. Click any venture: an ordered DO NEXT list generated from live pipeline state ("UNBLOCK FIRST: …" when your notes say something's blocking), a DONE timeline auto-pulled from your decisions log, live numbers, and every researched target as a searchable click-to-open card — pain hypothesis, decision-makers, phones linked.
💰 MONEY — a real P&L, not a vanity meter. Collected vs goal, days left, needed per day — plus a spend ledger (money out), net, and per-venture in/out/net so you see where the money actually comes from. A client-side path-to-goal simulator with knobs built from your own ventures answers "what combination of closes gets me there" without anything leaving the page. Cash counts only when collected, not quoted.
⌕ SEARCH — one box over everything. Type once in the live console and hit sessions, commits, decisions, leads, touches, and your inbox in the same result list. Full-text search over the activity ledger, literal match over the operator ledgers, all local.
✍ DRAFT — the reply, written for you, on your rails. Paste an inbound message and get a rails-correct draft built from the one-line offer you set per venture in config. Deterministic and local — no LLM call, and the drafter never quotes a number from the inbound message, only your canon prices. Edit, copy, log the send in one tap (which schedules the day-3 follow-up).
🔥 REPLIED + LEADS — the hot list, fed by anything. Drop a small JSON file (from an AI agent session reading your mail, a CRM export, a webhook you pipe to disk) and opsroom merges it: new leads dedup by phone into the register, and a reply from someone you pitched hits the top of NOW as a call-these-first block with a one-tap drafted answer. Replies schedule the call for today, not the day-3 cadence — a live reply is the hottest thing on the board. The drop file is the boundary: opsroom itself never touches the network.
📊 ACTIVITY — where your time actually went, by agent. A BY AGENT table (Claude vs Codex vs ChatGPT: sessions, active hours, top venture), sessions per venture, commits, and the two features that hurt (in a good way):
- Trap-zone drift: time spent in $0-revenue builds vs revenue ventures, with a red alert when building beats selling this week. The engineer's trap, made visible.
- Open loops: things you started and silently dropped — plan language in AI transcripts with no follow-up commit, stale branches, uncommitted work, in-progress notes going stale.
The sitrep
$ opsroom sitrep
SITREP · 2026-07-16
- DATE / DAYS TO GOAL: 2026-07-16 / 19d
- CASH COLLECTED vs Q3 $50K sprint: $8,250 collected
- OPEN LEADS: ~14 aged ~8d
- LIVE PIPELINE: Meridian: 2 proposals out ($12K + $18K) · 2 drafted, 1 sent, 2 call sheet
- TOP LEAK RIGHT NOW: ~14 open leads aged ~8d — paid-for money rotting uncalled
- SINGLE HIGHEST CASH ACTION TODAY: Finish the case-study PDF and send both proposals
Six lines, every morning, from live data. --write appends it to a daily note.
How it works
Read-only collectors, one local SQLite ledger, deterministic rendering:
| Source | What it reads |
|---|---|
cli |
Claude Code session logs (~/.claude/projects) — prompts, duration, outcomes |
codex |
OpenAI Codex CLI session logs (~/.codex/sessions) — same treatment, same attribution |
git |
every repo under your scan roots — commits, branches, uncommitted work |
fs |
mtime scan for non-git work |
notes |
your markdown roots — frontmatter, staleness, your dashboard note's ## Live state table |
chat |
manual drop of a chat export — both Claude (Anthropic) and ChatGPT (OpenAI) exports, sniffed by shape |
Attribution is by path: work done in ~/code/acme counts toward venture acme. Sessions are gap-capped active minutes, not wall clock.
Your notes are the API
opsroom doesn't make you adopt a system — it reads simple markdown conventions you can start using in five minutes:
- A dashboard note with a
## Live statetable (| Metric | Value | As of |) — rows are matched by key words (days to goal,cash, anything withlead), never by position, so reformatting won't break it. Ages keep ticking: "aged ~6 days" as-of last week reads correctly today. - A
## Today's one movesection → the console's hero action. - Pipeline trackers with
## Totalslines and## TOUCH LOGtables (Target | Channel | Status | Next) → your send/call queues. Any wide table in the same file → your searchable target list. - A
Decisions Log.mdwith- **YYYY-MM-DD** — …bullets → per-venture DONE timelines.
Security posture
This tool reads your terminal history and notes, so it's built paranoid:
- Fail-closed secret redaction — every event passes a redactor before touching the DB (API keys, AWS/GitHub/Slack/Stripe/Google tokens, JWTs, DB URIs, private keys, high-entropy
KEY=value). If redaction errors, the event is dropped, never written. - No network egress. Ever. Nothing phones home; the console HTML loads zero external resources. The only URLs are ones you configured as buttons.
- Local only — SQLite at
~/.local/share/opsroomwith600perms, refuses to live under a cloud-sync root (iCloud/Dropbox/OneDrive). - Read-only on all sources — your notes are never written; the only writes are the ledger and an optional append-only daily note.
opsroom purge --source=X/--before=DATEto shrink the blast radius any time.
Philosophy
Built during a 23-day cash sprint by an operator running eight ventures, out of one frustration: every productivity tool tracks activity; none of them track whether the activity pays. The rules encoded here are blunt:
- Cash counts when collected — not quoted, not booked, not "basically closed".
- Building instead of selling is a trap — visible on the board, hours counted.
- Everything you start and drop is a loop — it stays on the board until closed or dismissed.
- The console must answer "what do I do next" with names, numbers, and buttons — or it's just letters on a screen.
FAQ
Do I need Claude Code / Codex / Obsidian? No. Every source is optional and degrades gracefully. Git repos alone give you drift + loops + sessions; add notes when you want the money features.
Which AI agents are supported? Claude Code and OpenAI Codex CLI are read live from their local logs. ChatGPT and Claude web/desktop ingest via each vendor's data-export file dropped in a folder. Gemini CLI and Cursor are next — collectors are ~100-line files with one collect(con) entry point, PRs welcome.
macOS says the notes are unreadable. Grant your terminal Full Disk Access. If access drops mid-session, opsroom serves the last cached snapshot and says so.
Windows? WSL works. Native Windows is untested.
Development
git clone https://github.com/malekadjeb-ai/opsroom && cd opsroom
for t in tests/test_*.py; do python3 "$t" || break; done # seven gates, all must exit 0
python3 -m opsroom.cli demo
Stdlib only — there is nothing to pip install for development. MIT license.
Want to add a collector for your agent (Gemini CLI, Cursor, Aider, ...)? It's a ~100-line file — see CONTRIBUTING.md for the recipe and the open good first issues.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file opsroom_console-0.5.0.tar.gz.
File metadata
- Download URL: opsroom_console-0.5.0.tar.gz
- Upload date:
- Size: 93.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a8007bd0bce2229889ad1791fe1332a1626b5703252bca11598984881f000bd0
|
|
| MD5 |
48a203a422a01a94e63c1e689e26ea05
|
|
| BLAKE2b-256 |
3e365c8c0d66f7913b8a7c1f7d9a6158ac0e76fc99f4909cba4077b266effca9
|
File details
Details for the file opsroom_console-0.5.0-py3-none-any.whl.
File metadata
- Download URL: opsroom_console-0.5.0-py3-none-any.whl
- Upload date:
- Size: 88.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1425b25270bbc0dcd38a0f6bf990acfdb1ef1c44a732f0cf4a4f95e5610cbdf3
|
|
| MD5 |
467b1a2898928bb539c95c7580c48c17
|
|
| BLAKE2b-256 |
c7910620666c9f6432598dbc8859ca024c9e83e1cac066c4a7a904256ac5582f
|