cmux-diagnostics

cmux-diagnostics is a skill for Claude Code, Codex from DJRHails/dotfiles. It costs 77 tokens per session (845 once invoked), scanned A, a copy of cmux-diagnostics, MIT.

A read-only diagnostic tool for cmux, a macOS terminal app with workspaces, hooks, notifications, and browser automation. It creates a support-safe health report without exposing secrets or private session data.

In plain words
What is it for?
Use it for cmux health checks and troubleshooting CLI access, automation, notifications, session restore, settings, or agent resume problems.
Why use it?
It helps identify whether cmux commands, sockets, settings, hooks, or agent-resume behavior are working.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/djrhails/dotfiles/cmux-diagnostics
Any agent
npx skills add DJRHails/dotfiles --skill cmux-diagnostics
Clone the repo
git clone --depth 1 https://github.com/DJRHails/dotfiles

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cmux-diagnostics

README.md
[![agentmods](https://agentmods.dev/badge/skills/djrhails/dotfiles/cmux-diagnostics.svg)](https://agentmods.dev/skills/djrhails/dotfiles/cmux-diagnostics)
Your own site
<a href="https://agentmods.dev/skills/djrhails/dotfiles/cmux-diagnostics"><img src="https://agentmods.dev/badge/skills/djrhails/dotfiles/cmux-diagnostics.svg" alt="Measured on agentmods" height="20"></a>
Per session 77 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 845 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 95% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00077 $0.00845
Opus 5 $0.00039 $0.00423
Sonnet 5 $0.00015 $0.00169
Haiku 4.5 $0.00008 $0.00085

Measured 4d ago against content hash d17f246e99ae, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

cmux-diagnostics scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

95% identical to cmux-diagnostics — 2 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

modules/agents/skills/cmux-diagnostics/SKILL.md · 95 lines

How it starts

The opening of the file, as written. The whole thing — 95 lines — stays where its author put it; the contents beside it link to each section on GitHub.

cmux Diagnostics

Use this skill to collect and interpret support-safe cmux diagnostics for end users. Default to read-only checks. Do not dump hook config files, session stores, prompt logs, tokens, or environment secrets.

Quick Report

Run the bundled read-only diagnostic script first:

# From a cmux checkout
skills/cmux-diagnostics/scripts/cmux-diagnostics

# From an installed skill
~/.agents/skills/cmux-diagnostics/scripts/cmux-diagnostics

# From a Codex-only skills.sh install
~/.codex/skills/cmux-diagnostics/scripts/cmux-diagnostics

Use --include-context only when workspace names, cwd paths, and current cmux identifiers are relevant to the user-reported issue:

skills/cmux-diagnostics/scripts/cmux-diagnostics --include-context

What to Check

  1. CLI and socket health:

    command -v cmux
    cmux ping
    cmux capabilities --json
    

    If socket commands fail, check whether the agent is running inside a cmux terminal and whether socket automation is enabled.

  2. Settings health:

    ~/.agents/skills/cmux-settings/scripts/cmux-settings validate
    ~/.agents/skills/cmux-settings/scripts/cmux-settings get terminal.autoResumeAgentSessions
    

    If the user installed with skills.sh, use ~/.codex/skills/cmux-settings/scripts/cmux-settings instead. If terminal.autoResumeAgentSessions is false, cmux restores panes but will not automatically resume saved agent sessions.

  3. Hook installation:

    cmux hooks setup --agent codex
    cmux hooks setup --agent opencode
    cmux hooks setup
    

    Only run install or uninstall commands after the user agrees. cmux hooks setup installs supported agents found on PATH and skips missing agents.

  4. Session restore evidence:

    ls -lh ~/.cmuxterm/*-hook-sessions.json 2>/dev/null
    

    Missing session stores usually means the agent has not run inside cmux since hooks were installed, hooks are disabled, or the agent integration does not support resume capture.

Read the full file on GitHub · 95 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 95 lines · 77 tokens per session scan A d17f246e99ae

Subscribe to this mod's changes

cmux-diagnostics is a skill published in the GitHub repository DJRHails/dotfiles (2 stars, last pushed today), licensed MIT. It adds 77 tokens to every session and 845 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. It is 95% identical to cmux-diagnostics, differing in 2 lines, and is treated as a copy.

Related

Other skills, from other repositories

walkthrough

Generate a hands-on browser walkthrough of a PR's user-facing changes to exercise before review; --publish posts the final version to the PR for QA.

joshukraine/dotfiles · 33 tokens

prd-view

Render a PRD Markdown file as a rich, self-contained HTML reading view (Dashboard style) and open it in the browser. The Markdown stays authoritative; the HTML is a derived, ephemeral presentation.

joshukraine/dotfiles · 43 tokens

autopilot-batch

Fan out a batch of autopilot-queued issues to parallel background worktree subagents — each runs /autopilot at the build model from its 'model:' label — with a gating review at Opus 5 or above and never below the build (Opus reviews Sonnet and Opus builds, Fable reviews Fable builds).

joshukraine/dotfiles · 75 tokens

todoist-cli

Manage Todoist tasks, projects, labels, filters, sections, comments, reminders, and workspaces via the td CLI. Use when the user wants to view, create, update, complete, or organize Todoist items, or mentions tasks, inbox, today, upcoming, projects, labels, or filters.

joshukraine/dotfiles · 68 tokens

autopilot

Carry a well-scoped GitHub issue through the full dev loop autonomously, stopping at a per-run tier boundary (PR-ready, or merge+deploy for small reversible changes).

joshukraine/dotfiles · 40 tokens

qa-handoff

Generate a hands-on QA testing guide as a self-contained HTML page — for Rails apps or static (Hugo) sites. --publish uploads the HTML to the project's configured QA host.

joshukraine/dotfiles · 41 tokens