Skip to content
Skills Library
Programming · Tool integration

setup

/setup

Installs wakemux from a git clone, checks the machine with `wakemux doctor`, writes the user's wakemux settings after asking about them, and uninstalls wakemux completely. Use it when the user asks to install, set up, configure, check or uninstall wakemux, or pastes the setup prompt from the wakemux README. Also works before wakemux is installed, read straight from a clone.

Repository
wakemux ↗
Licence
MIT
Last repository change
13.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Installs wakemux from a git clone, checks the machine with `wakemux doctor`, writes the user's wakemux settings after asking about them, and uninstalls wakemux completely. Use it when the user asks to install, set up, configure, check or uninstall wakemux, or pastes the setup prompt from the wakemux README. Also works before wakemux is installed, read straight from a clone.

Original author description

Installs wakemux from a git clone, checks the machine with `wakemux doctor`, writes the user's wakemux settings after asking about them, and uninstalls wakemux completely. Use it when the user asks to install, set up, configure, check or uninstall wakemux, or pastes the setup prompt from the wakemux README. Also works before wakemux is installed, read straight from a clone.

How it works

  1. 1. Check the place
  2. 2. Get the code
  3. 3. Check the machine
  4. 4. Settings
  5. 5. Finish
  6. Uninstall
Original SKILL.md headings · 71 lines, 1,024 words
SKILL.md preview
---
name: setup
description: Installs wakemux from a git clone, checks the machine with `wakemux doctor`, writes the user's wakemux settings after asking about them, and uninstalls wakemux completely. Use it when the user asks to install, set up, configure, check or uninstall wakemux, or pastes the setup prompt from the wakemux README. Also works before wakemux is installed, read straight from a clone.
---

# Set up wakemux

Work through the steps in order. Ask before you install software, overwrite a file or change shell settings. Report each step's result in one line.

Change files only through `install.sh` and `wakemux config set`. They note every change in `~/.local/state/wakemux/manifest.tsv` and keep a backup of each original, so the uninstall below can restore it. Do not edit the user's shell profile or settings file by hand.

The clone lives in `~/.local/share/wakemux` unless the user names another folder or wakemux is already installed. Call it `<clone>` below. `<wakemux>` means `<clone>/bin/wakemux` for a clone install and plain `wakemux` for a marketplace install; pick it in step 2 and use it throughout.

## 1. Check the place

- `uname` must print `Darwin`. Otherwise say wakemux runs on macOS only and stop.
- `echo $CMUX_WORKSPACE_ID` must print something. If it is empty, say that this session does not run in a cmux terminal. Setup can continue, but the user has to start Claude Code from a cmux terminal to use wakemux.

## 2. Get the code

Check what exists:

- `claude plugin list` shows `wakemux@wakemux`: the marketplace install is in place. Skip to step 3 and use `wakemux` from the Bash tool, which Claude Code provides for installed plugins. Do not also run `install.sh`.
- `<clone>/.git` exists: run `git -C <clone> pull --ff-only`.
- Neither: run `git clone https://github.com/mschmdb/wakemux.git <clone>`.

Then run `<clone>/install.sh`. It links the clone into the Claude Code skills folder and `bin/wakemux` into `~/.local/bin`. If it refuses because something already exists at a target, show the user its message and ask what to do. Never delete the existing file yourself.

If `install.sh` notes that `~/.local/bin` is not on the PATH, offer to run `<clone>/install.sh --add-path`. It backs up the shell profile and adds a marked block that uninstall removes again. Only with a yes.

## 3. Check the machine

Run `<wakemux> doctor`. For each line:

- `FAIL`: explain what is missing and how to get it. Install nothing without the user's yes.
- `warn  not inside a cmux terminal` and `warn  claude does not run through the cmux wrapper`: the user must start Claude Code from a cmux terminal. Reports cannot wake sessions started elsewhere.
- `warn  wakemux plugin not installed`: expected right after `install.sh`; Claude Code loads the plugin in the next session.
- `warn  settings: ...`: fix it in step 4.

## 4. Settings

Show the current values with `<wakemux> config`. Then ask these questions in one message, each with the default as the suggested answer:

1. GitHub organizations whose repositories require pull requests (`prRequiredOrgs`, default none). Example: the user's employer.
2. Git-ignored files to copy into each new thread (`copyFiles`, default `.env`).
3. How many threads may be open per repository (`maxThreads`, default 4, `0` for no limit).
4. Browser and dev server next to each thread for web projects (`devLayout`, default `auto`, or `off`).

Set only the answers that differ from the default, one command each, for example `<wakemux> config set prRequiredOrgs "acme, beta"` and `<wakemux> config set maxThreads 6`. The command validates the value, keeps the file's other keys and backs up the original before the first change. Show the user the commands before you run them. Settings for one repository belong in `.wakemux.json` in that repository; mention this, do not create it.

Run `<wakemux> config` again and confirm the values. `docs/configuration.md` lists every setting (in the clone, or at https://github.com/mschmdb/wakemux/blob/main/docs/configuration.md).

Then offer the `SendMessage` allow rule. When cmux cannot deliver a report, the thread forwards it through Claude Code, and Claude Code asks for approval in the thread first. The report waits until someone approves it there. Explain the trade-off in two sentences: with the rule, Claude Code no longer asks before any `SendMessage`, also when the model sends one in any session; without it, a forwarded report waits for a click in the thread. Only with a yes, ask the user to add `SendMessage` on the Allow tab of `/permissions`, or to put `"SendMessage"` into `permissions.allow` of `~/.claude/settings.json` themselves. Do not edit that file yourself, and tell the user that the uninstall does not remove the rule.

## 5. Finish

Tell the user:

- Start a new Claude Code session from a cmux terminal, in a project's main checkout.
- `/wakemux` opens the threads pane there.
- Ask for any side task "as a thread" to start one.

If the user had an older, hand-made version of this setup, for example a `thread` skill in `~/.claude/skills/thread` or another plugin that reports thread turns, point out that both would run side by side, and ask whether to disable the old one.

## Uninstall

When the user asks to remove wakemux:

1. **Open threads.** Run `git worktree list` in the current repository and in each repository listed with `exclude` in `~/.local/state/wakemux/manifest.tsv`. Name every thread worktree with uncommitted changes or commits not merged into its base. Ask the user to land or clean them up first, or to confirm that they stay. Never delete a worktree or a branch yourself.
2. **Settings.** Ask whether the user wants their wakemux settings back as they were before (`--purge`) or kept for a later install.
3. **Run the uninstall** with `${CLAUDE_PLUGIN_ROOT}/install.sh --uninstall`, plus `--purge` if the user chose it. It removes the links and the PATH block from the shell profile. With `--purge` it also restores the settings file from its backup (or removes it if wakemux created it), takes `.claude/worktrees/` out of `.git/info/exclude` in repositories without open threads, and deletes `~/.local/state/wakemux`. Show the user its output.
4. **Marketplace install:** afterwards run `claude plugin uninstall wakemux@wakemux` and `claude plugin marketplace remove wakemux`.
5. **The clone:** if `git -C <clone> status --porcelain` prints nothing, offer to delete the clone folder. Delete it only with a yes.
6. **Tell the user what stays,** because wakemux did not create it or cannot know it is unused: thread branches and worktrees they kept, `.wakemux.json` files in repositories, cmux workspace groups and the workspace renamed `main`, and a settings file that wakemux never changed (for example one the user wrote by hand). Start a new Claude Code session so the plugin is gone from it.

Versions

RepositoryScoreLicence
This page · mschmdb/wakemux100MIT
HwangSlater/harness-fit100MIT
nesquikm/dev-process-toolkit100MIT
userKael/rastro100MIT
als-apg/osprey100BSD-3-Clause
dedujeong/gemba100Apache-2.0
eigenwise/eigenwise-toolshed100MIT
awrshift/agent-memory-kit100MIT
lifecycle-innovations-limited/claude-ops100MIT

Database snapshot: 13.11.2026 · package version 9ba942f1051d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100manage-skills
    Install, remove, and inspect skills from a clone of the kapo-skills repo. Use when someone asks to install or add a skill, see which skills they have, remove or uninstall a skill, update their shared skills, or when a skill that should be available isn't showing up.
  • 96doctor
    Checks that every tool and plugin Pavedline needs is installed and, for anything missing, tells the user what it will install and why, then installs it. Use at the start of step 0 (before /pavedline:start does anything else), and whenever a command is not found or a dependency seems missing.
  • 100setup-kit
    Set up or update AI-agent files (optionally with a minimal, team or strict profile), agent guards, lint/CI checks and repository settings in the current project, in any language. Use when the user runs /setup-kit, asks to "set up the kit", "add AGENTS.md and checks", "configure…
  • 100austere-setup
    Set up austere-axi on this machine for the user. Checks Node, installs the `austere` skill, optionally installs the CLI globally and turns on the hub, then proves the review loop works with a test page. Use when the user asks to install, set up or configure austere-axi.
  • 98mmsetup
    Set up, reconfigure, or remove Memory Mason. Configures vault path, installs hooks if missing, or uninstalls everything. Use when the user says "set up memory mason", "install hooks", "configure memory mason", "reconfigure memory mason", "get memory mason running", "my hooks…
  • 90setup-workstation
    Take a machine from nothing to fully equipped for building Power Platform solutions with AI agents - installs the CLIs, SDKs, runtimes, Microsoft and Powercademy plugin marketplaces, workload plugins and recommended MCP servers, signs in, verifies everything works, and ends with…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.