Skip to main content

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

ci python deps license

Your AI agents write code all day. opsroom shows you whether any of it pays.

opsroom demo — sitrep, by-agent, trap-zone alert

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 — one ranked action stack. Everything worth doing — a live reply, a due follow-up, the top move, staged drafts, phone-first targets, aged leads, an agent's staged promise — collapses into a single list, money-ranked, most-important first. Every row is DOable in place: draft the reply, tap-to-dial the number, dispatch it to an agent, mark it done. No hunting across tabs. Above it: today's pace (collected vs what today needs) and a live view of which AI agents are running right now.

opsroom console — the NOW action queue

🏢 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).

🟢 AGENTS RUNNING — see your live sessions, cowork and all. opsroom reads which Claude Code sessions are alive right now (interactive, cowork, background), attributes each to a venture, and flags the cowork/background ones — so you can see an agent working for you on a venture as it happens, not just after the fact in the rollup.

▶ DO IT — every action becomes a hand-off, and your agents close the loop. opsroom reads what your AI agents did all day; now it writes back. Every queued action — the top cash move, a DO NEXT step, a due follow-up, a staged promise — gets a ▶ button that opens the full work brief: the task, your config rails, and the live operator context. Copy it into any AI chat, or opt in ([agent] enabled = true in config) and one tap launches your local agent CLI (e.g. claude -p) on the brief, detached, logged locally. The command comes only from your config, the brief is passed as a single argument, and it's off by default.

🔥 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):

opsroom ACTIVITY — by agent, drift, open loops

  • 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 state table (| Metric | Value | As of |) — rows are matched by key words (days to goal, cash, anything with lead), 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 move section → the console's hero action.
  • Pipeline trackers with ## Totals lines and ## TOUCH LOG tables (Target | Channel | Status | Next) → your send/call queues. Any wide table in the same file → your searchable target list.
  • A Decisions Log.md with - **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/opsroom with 600 perms, 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=DATE to 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:

  1. Cash counts when collected — not quoted, not booked, not "basically closed".
  2. Building instead of selling is a trap — visible on the board, hours counted.
  3. Everything you start and drop is a loop — it stays on the board until closed or dismissed.
  4. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

opsroom_console-0.7.0.tar.gz (105.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

opsroom_console-0.7.0-py3-none-any.whl (97.9 kB view details)

Uploaded Python 3

File details

Details for the file opsroom_console-0.7.0.tar.gz.

File metadata

  • Download URL: opsroom_console-0.7.0.tar.gz
  • Upload date:
  • Size: 105.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for opsroom_console-0.7.0.tar.gz
Algorithm Hash digest
SHA256 d79c87e7868e85a356a13f80d256da8568025f0b80e1d75c9c8f7643b14aaad0
MD5 7ea72de8d18c79b962330543a7cce90b
BLAKE2b-256 5195526f11bd2b8b94c70b75a286438aba6b6ccb80287486b3530e94944b7367

See more details on using hashes here.

File details

Details for the file opsroom_console-0.7.0-py3-none-any.whl.

File metadata

File hashes

Hashes for opsroom_console-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bcdd22a79f1c115fdc9472d0e88ed5f0ab144fb712c87fdc60c04224a6795657
MD5 2e5776ab406a40d5e319b52712804416
BLAKE2b-256 9db2df7d5573ea5a5f7ed3f34591e27abdfc42a53e1610b03de6062cd3b105e6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page