wispterm-diagnostics

wispterm-diagnostics is a skill for Codex from xuzhougeng/wispterm. It costs 88 tokens per session (3,005 once invoked), scanned A, original, MIT.

A procedure for preparing a safe, shareable diagnostic report for WispTerm, a terminal application. It gathers relevant application, operating-system, connection, display, browser-panel, and log details for reported problems.

In plain words
What is it for?
Use it to collect troubleshooting details for WispTerm issues such as SSH disconnections, copying or scrolling bugs, image previews, HTML previews, and high CPU use.
Why use it?
It gives support or developers the context needed to investigate crashes, display issues, input problems, SSH failures, and similar faults.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: $skill-name invocation.

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/xuzhougeng/wispterm/wispterm-diagnostics
Any agent
npx skills add xuzhougeng/wispterm --skill wispterm-diagnostics
Clone the repo
git clone --depth 1 https://github.com/xuzhougeng/wispterm

Made for: 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 wispterm-diagnostics

README.md
[![agentmods](https://agentmods.dev/badge/skills/xuzhougeng/wispterm/wispterm-diagnostics.svg)](https://agentmods.dev/skills/xuzhougeng/wispterm/wispterm-diagnostics)
Your own site
<a href="https://agentmods.dev/skills/xuzhougeng/wispterm/wispterm-diagnostics"><img src="https://agentmods.dev/badge/skills/xuzhougeng/wispterm/wispterm-diagnostics.svg" alt="Measured on agentmods" height="20"></a>
Per session 88 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,005 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found 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.1 $0.00088 $0.03005
Opus 5 $0.00044 $0.01503
Sonnet 5 $0.00018 $0.00601
Haiku 4.5 $0.00009 $0.00300

Measured 6d ago against content hash 1b8404e53458, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

wispterm-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 6d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/collect_wispterm_diagnostics.ps1), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

plugins/skills/wispterm-diagnostics/SKILL.md · 287 lines

How it starts

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

WispTerm Diagnostics

Overview

Generate a safe, copyable Markdown diagnostic report for users filing WispTerm issues. On Windows, installed WispTerm release packages include this plugin, so the preferred user-facing path is to ask the user to invoke $wispterm-diagnostics from WispTerm's AI Chat or Copilot and include their symptoms/reproduction steps. The skill then uses the bundled PowerShell script to collect WispTerm, Windows, OpenSSH, WebView2, bundled ConPTY, GPU, logs, and config details. Do not ask Windows users to find a source checkout first.

On macOS, there is no equivalent script yet — use the manual bash workflow in the macOS section below.

Windows Workflow

  1. If a user needs instructions, tell them to open a WispTerm AI Chat tab or Copilot sidebar and send a request like:
$wispterm-diagnostics
Problem type: ssh-disconnect
Symptom: SSH Profile disconnects after 5-10 minutes idle with "Connection reset".
Repro steps: connect to the saved SSH profile, leave it idle, then run ls.
What I already tried: external ssh.exe with ServerAliveInterval works.
  1. Infer -ProblemType from the user's text. If it is unclear, use other and keep the user's symptom/repro text in the generated issue draft.
  2. Run the script from this skill directory as the implementation detail:
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\collect_wispterm_diagnostics.ps1 -ProblemType "other"

Use pwsh instead of powershell only if Windows PowerShell is unavailable.

Recommended labels: startup/crash, rendering/DPI, high-cpu, keyboard/input, selection/copy/scrolling, SSH/SCP, ssh-image-preview, html-preview, ssh-disconnect, file explorer, WebView2/browser panel, updater, remote console, other.

  1. For rendering/DPI/multi-monitor glitch reports, first check whether render-diagnostic.log is already present. If not, ask the user to add wispterm-debug-render = true to their config (press Ctrl+, to open it), restart WispTerm, reproduce the glitch, then run the script. The log is written to %APPDATA%\wispterm\render-diagnostic.log.

Read the full file on GitHub · 287 lines

Files

What ships with it

2 files 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. 6d ago First seen · 287 lines · 88 tokens per session scan A 1b8404e53458

Subscribe to this mod's changes

wispterm-diagnostics is a skill published in the GitHub repository xuzhougeng/wispterm (402 stars, last pushed today), licensed MIT. It adds 88 tokens to every session and 3,005 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

liney-cli

Use the Liney CLI (liney) to inspect or control a running Liney terminal workspace and the agent sessions it hosts. Liney runs several coding agents in parallel, each in its own pane/tab/worktree, so reach for this whenever the user wants to act on a pane other than the current one — check on, coordinate, read from…

everettjf/liney · 195 tokens

terminal-setup-install

Idempotent macOS terminal installer for Ghostty, Oh My Zsh, Powerlevel10k, Glow, MesloLGS Nerd Font, plus optional markdown preview and clickable-path extras.

YoungLeadersDotTech/young-leaders-tech-marketplace · 44 tokens

computer-use

Use Orca's computer-use CLI for OS/window-level inspection and input in visible local app windows. Use when a task must read or operate a native app or an external browser window (for example, Chrome, Edge, or Safari) or an app webview. Do not use for Orca's embedded browser or page-only browser automation. Use…

stablyai/orca · 99 tokens

linear-tickets

Use Orca's Linear CLI through orca linear ... commands to read linked ticket context with orca linear issue --current --full --json, post completion updates, move work forward through Linear workflow states, attach PR/MR links with orca linear attach --current --url --title "PR/MR link" --json, and triage Linear tasks…

stablyai/orca · 160 tokens

orca-cli

Use the public orca CLI to operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and the browser embedded inside the Orca app. Use when the user says "$orca-cli", "use orca cli", "Orca worktree", "child worktree", "cardStatus", "spawn codex/claude…

stablyai/orca · 249 tokens

orca-emulator-android

Control an Android emulator / device from inside Orca using the orca CLI. Use for listing/booting AVDs, taps, swipes, typing, hardware buttons (incl. Back and Recents), rotation, app install/launch, runtime permissions, the accessibility tree, and logcat — driving a real adb-connected device or emulator.…

stablyai/orca · 104 tokens