Ops Dash

OPS > DASH — Interactive Command Center

Load ops-rules before acting. Public repo (no personal data). Outbound: one draft → one approval → one send. If AskUserQuestion / Workflow are missing, follow Rule 10 in ops-rules (Hermes: numbered options / two-turn Telegram card; delegate_task).

Runtime Context

Before rendering, load available context:

1. Preferences: Read ${CLAUDE_PLUGIN_DATA_DIR:-$HOME/.claude/plugins/data/ops-ops-marketplace}/preferences.json

   • owner — personalize the dashboard header greeting
   • timezone — display timestamps correctly in status indicators

2. Daemon health: Read ${CLAUDE_PLUGIN_DATA_DIR}/daemon-health.json

   • If action_needed is not null → show a warning banner at the top of the dashboard before the menu

Agent Teams support

If CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 is set, use Agent Teams when loading dashboard data in parallel. This enables:

• Agents share context and can coordinate mid-flight
• You can steer priorities in real-time
• Agents report progress as they complete

Team setup (only when flag is enabled):

Copy code
TeamCreate("dash-team")
Agent(team_name="dash-team", name="infra-loader", prompt="Gather ECS health, Vercel status, and CI pipeline state")
Agent(team_name="dash-team", name="comms-loader", prompt="Gather unread counts across all configured channels")
Agent(team_name="dash-team", name="projects-loader", prompt="Gather GSD phase, git status, and PRs for all projects")
Agent(team_name="dash-team", name="business-loader", prompt="Gather revenue, Linear sprint, and fire alerts")

If the flag is NOT set, use standard fire-and-forget subagents.

Render dashboard instantly

Copy code
${CLAUDE_PLUGIN_ROOT}/bin/ops-dash 2>/dev/null || echo "DASH_RENDER_FAILED"

Your task

The dashboard has already rendered above via the shell script — the user can see the full colored ANSI output directly. Your job is to route user input to the right skill.

DO NOT re-render, re-print, summarize, transcribe, or describe the dashboard output. The user sees the rich colored render above; any plain-text re-statement is duplicate noise and destroys the visual quality.

Skip straight to AskUserQuestion for the next action — no preamble, no recap, no "vitals" summary line. The dashboard speaks for itself.

Routing table

C-suite report access (option e)

When user selects e:

1. Find latest YOLO session: ls -td /tmp/yolo-*/ 2>/dev/null | head -1
2. If found, show a sub-menu:

Display the C-suite header, then use batched AskUserQuestion (max 4 options per call):

Copy code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 OPS > C-SUITE REPORTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

AskUserQuestion call 1:

Copy code
  [CEO — Strategic analysis]
  [CTO — Technical health]
  [CFO — Financial analysis]
  [More...]

AskUserQuestion call 2 (only if "More..."):

Copy code
  [COO — Operations review]
  [All — Full Hard Truths report]
  [Back to dashboard]

Read the selected file and display it. After display, offer [Back to dashboard].

3. If no YOLO reports exist:

Copy code
No C-suite reports yet. Run /ops:ops-yolo to generate one.

 b) Back to dashboard

Settings sub-menu (option f)

When user selects f, read current preferences and present an interactive config editor.

bashCopy code
PREFS="${CLAUDE_PLUGIN_DATA_DIR:-$HOME/.claude/plugins/data/ops-ops-marketplace}/preferences.json"
cat "$PREFS" 2>/dev/null || echo '{}'

bashCopy code
cat "${CLAUDE_PLUGIN_ROOT}/scripts/registry.json" 2>/dev/null || echo '{}'

Display the full settings menu as text (for reference), then use batched AskUserQuestion calls (max 4 options each) to let the user pick a category:

Copy code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 OPS > SETTINGS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

 PROFILE:       Owner=[value] | TZ=[value] | Style=[value]
 CHANNELS:      Email=[✓/✗] | WA=[✓/✗] | Slack=[N workspaces/✗] | Telegram=[✓/✗]
 INTEGRATIONS:  AWS=[value] | Sentry=[value] | Linear=[value]
 PROJECTS:      [N] registered
 PLUGIN:        v[version]
──────────────────────────────────────────────────────

Use AskUserQuestion (max 4 options):

Copy code
What would you like to configure?
  [Profile (name/timezone/style)]
  [Channels (email/WA/slack/telegram)]
  [Integrations & Projects]
  [Back to dashboard]

On "Profile": use AskUserQuestion with [Owner name], [Timezone], [Briefing style], [Back]. On "Channels": use AskUserQuestion with the 4 channel names (fits in one call). On "Integrations & Projects": use AskUserQuestion with [AWS/Sentry/Linear], [View registry], [Add/remove project], [Update plugin / Re-run setup].

For each option, use AskUserQuestion to get the new value, then write to preferences.json or registry.json.

Writing preferences:

bashCopy code
PREFS="${CLAUDE_PLUGIN_DATA_DIR:-$HOME/.claude/plugins/data/ops-ops-marketplace}/preferences.json"
# Read existing, merge update, write back
jq --arg key "owner" --arg val "$NEW_VALUE" '.[$key] = $val' "$PREFS" > "${PREFS}.tmp" && mv "${PREFS}.tmp" "$PREFS"

After each change, confirm success and return to the settings menu. User can keep making changes or press b to go back.

Share sub-menu (option g)

When user selects g, generate a shareable summary of their ops setup:

Display the share header, then use batched AskUserQuestion (max 4 options per call):

Copy code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 OPS > SHARE YOUR SETUP
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

AskUserQuestion call 1:

Copy code
  [Share on X (Twitter)]
  [Share via Slack]
  [Share via Email]
  [More...]

AskUserQuestion call 2 (only if "More..."):

Copy code
  [Copy to clipboard]
  [Export setup guide (markdown)]
  [Back to dashboard]

Share content generation

Generate a share-ready message. Never include secrets, tokens, or private project names. Only share:

• Plugin version
• Number of integrations configured
• Number of projects managed
• OS and system info
• Feature highlights used

Template:

Copy code
I'm running my business from Claude Code with claude-ops v0.3.1

Setup: [N] projects | [N] channels | [OS]
Features: Morning briefing, inbox zero, fire alerts, C-suite AI analysis, system optimizer

Try it: /plugin marketplace add ops-marketplace

#ClaudeCode #DevOps #AI

Share actions

FAQ sub-menu (option ?)

When user selects ? (or faq/help/wiki):

Copy code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 OPS > HELP & FAQ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

 QUICK START
 1) What is claude-ops?
 2) How do I set up channels?
 3) How does YOLO mode work?
 4) What data does ops collect?

 COMMANDS
 5) Full command reference
 6) Keyboard shortcuts

 TROUBLESHOOTING
 7) MCP server disconnected
 8) WhatsApp not connecting
 9) Telegram auth issues
 10) Channel not showing unread

 LINKS
 w) Wiki — github.com/Lifecycle-Innovations-Limited/claude-ops/wiki
 r) README — github.com/Lifecycle-Innovations-Limited/claude-ops
 i) Issues — github.com/Lifecycle-Innovations-Limited/claude-ops/issues
 c) Changelog

──────────────────────────────────────────────────────
 b) Back to dashboard
──────────────────────────────────────────────────────

FAQ answers

| # | Question | Answer | | --- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | What is claude-ops? | Business operations OS for Claude Code. Manages inbox, fires, deploys, PRs, revenue, and can run your business autonomously via YOLO mode. | | 2 | Channel setup | Run /ops:setup — interactive wizard detects installed CLIs and walks you through each channel. | | 3 | YOLO mode | Spawns 4 AI agents (CEO, CTO, CFO, COO) to analyze your business. Type YOLO to hand over controls — it processes inbox, fixes fires, merges PRs, and advances GSD phases. | | 4 | Data collection | All data stays local. No telemetry. Registry and preferences are gitignored. Tokens stored in macOS keychain or env vars. | | 5 | Command reference | List all /ops:* commands with descriptions | | 6 | Shortcuts | 1-9, 0 for actions, a-h for power/comms/settings, b always goes back, q exits | | 7 | MCP disconnected | Wait 5s and retry (auto-reconnect hook). After 3 fails, falls back to CLI tools. | | 8 | WhatsApp | Check bridge liveness: lsof -i :8080 | grep LISTEN. If not running, prompt restart: launchctl kickstart -k gui/$(id -u)/com.${USER}.whatsapp-bridge. Check launchctl list com.${USER}.whatsapp-bridgefor status. If store locked:kill $(pgrep whatsapp-bridge). | | 9 | Telegram | Needs user-auth (not bot). Run /ops:setup → Telegram section. API ID + hash from my.telegram.org. | | 10 | Unread | Channel must be configured in /ops:setup. Check ops-unread script output for errors. | | 11 | Smart-home (Homey) | Run /ops:setup --section home to configure Homey Pro. Once set, hotkey h and /ops:ops-home are routable. Status dot on the dashboard: green = all devices online + no alarms, yellow = device offline, red = active critical alarm. |

For links (w, r, i): open in browser via open (macOS) or xdg-open (Linux).

For changelog (c): read and display ${CLAUDE_PLUGIN_ROOT}/CHANGELOG.md.

After each FAQ answer, offer b) Back to dashboard or h) Back to FAQ.

Return-to-dash loop

After ANY skill completes and returns control, re-render the dashboard by running the bin script again and re-entering the routing loop. This creates the "app within an app" experience — the user always comes back to the command center.

To re-render:

bashCopy code
${CLAUDE_PLUGIN_ROOT}/bin/ops-dash 2>/dev/null

Then AskUserQuestion again for the next action.

Exception: If user types q, quit, or exit, end the session gracefully:

Copy code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 OPS > SESSION ENDED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

If $ARGUMENTS is back

Re-render the dashboard and enter routing loop.

If $ARGUMENTS is settings

Jump directly to settings sub-menu (skip dashboard render).

If $ARGUMENTS is share

Jump directly to share sub-menu.

If $ARGUMENTS is faq

Jump directly to FAQ sub-menu.

Setup gate

If the dashboard script outputs DASH_RENDER_FAILED or the preferences file doesn't exist, show:

Copy code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 OPS > SETUP REQUIRED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

 Run /ops:setup to configure your integrations first.

Then invoke /ops:setup directly.

Windsor.ai (optional live data)

If Windsor.ai is connected (mcp__*Windsor*__* or a windsor_api_key), use it as the live cross-channel source for all live KPIs (spend, ROAS, CAC, sessions, social reach) for the command-center tiles, flagging deviations vs 7d/30d. Map accounts per project via registry.json → .projects[].windsor. Prefer blended ROAS (store/analytics revenue ÷ total ad spend) over platform-reported ROAS. See docs/integrations/windsor-ai.md for the full playbook (REST + MCP modes, registry mapping, analysis mandate, and caveats). Data sanity: if Windsor returns only zeros across sources (Meta + Google spend/impressions and Instagram reach all exactly 0 over 30d while accounts are connected), treat the data as unavailable — the plan may be expired (check get_current_user → is_paid) — warn the user, and never present zeros as real metrics. scripts/windsor-data-sanity.sh automates the check.

Windsor is optional. If Windsor is not connected, returns errors, or returns the all-zero pattern, fall back to the free direct libraries: scripts/lib/ad-spend-aggregator.sh (paid), scripts/lib/ga4-data-api.sh (analytics), and scripts/lib/organic-metrics-aggregator.sh (organic + merchant). See docs/integrations/direct-channel-wiring.md. Never present zeros from a dead source as real metrics.

Additional resources

CLI detail: references/cli.md.