wsx config get <key>
wsx config set <key> <value-or-@file>
wsx config list
wsx config edit <key> # opens $EDITOR (default: vi)
Known keys:
| Key | Effect |
|---|---|
branch_prefix | Default branch prefix for repos with no per-repo override. Branches are named <prefix>/<workspace>. |
custom_instructions | Free-text appended to claude's system prompt on every workspace spawn. |
process_doctrine | Standing "operating doctrine" injected into every developer session (new and resumed) across all agents: think and plan before scope is set, use the superpowers skills by default (Claude/Pi only), break work into logical commits, and load the wsx skill. Not applied to the Project Manager session. Set this to replace the default text verbatim (@file supported); set it to off / none / disabled to suppress injection entirely. A blank value restores the default (it is not an off switch). |
coding_agent | Default coding agent for new workspaces and the Project Manager pane: claude (default) / pi / hermes / codex. Per-workspace override via wsx workspace create <repo> --agent <agent> (does not affect the PM). See Coding agents. |
nerd_fonts | Render nerd-font glyphs in the dashboard. Default ON; set to false / 0 / off to disable. |
editor_cmd | Command to run for [e] edit on the dashboard. Worktree path appended as final arg unless the command contains {path} (substituted in place). Examples: code, cursor, alacritty -e nvim, xdg-terminal-exec --dir={path} nvim. Also required for the chronology bar's "open at changed line" action; see Change chronology for the {file}/{line} injection details. |
terminal_cmd | Command to run for [t] terminal on the dashboard. Spawned with cwd=worktree; {path} substituted in place if present. Examples: alacritty, kitty, gnome-terminal. |
notifications | Ring the terminal bell and show a ! marker when a workspace transitions to waiting (claude paused for ≥30s). Default ON; set to off / false / 0 / no to disable. |
theme | Color theme. One of default (palette-adaptive ANSI), dracula (RGB), jellybeans (RGB), nord (RGB). Unknown values fall back to default. Restart wsx after changing. |
pm_enabled | Enable the Project Manager pane (p keybind). Default ON; set to off / false / 0 / no to disable. |
pm_custom_instructions | Free-text appended to the project manager's system prompt. Same @file / empty-clears semantics as custom_instructions. |
pm_fast_mode | Launch the Project Manager session with Claude Code's fast mode enabled (--settings '{"fastMode":true}'). PM is a status-summary session, so fast output is usually the right tradeoff. Only applies when the PM agent is claude (Pi/Hermes/Codex have no fast mode); ignored otherwise. Default OFF; set to on / true / 1 / yes to enable. |
mcp_mirror | Inherit MCP servers from the source repo into worktrees (see MCP server inheritance). Default ON; set to off / false / 0 / no to disable. |
remote_control | Pass --remote-control to claude on every spawn so the session is reachable via claude.ai/code and the Claude mobile app (see Remote control). Default ON; set to off / false / 0 / no to disable. |
remote_control_sandbox | When remote_control is on, also pass --sandbox for an extra safety wrapper on remote-issued commands. Default OFF; set to on / true / 1 / yes to enable. |
pinned_commands | Newline-separated list of Label=command (or bare command) entries. Each becomes a chip in the attached view, fired via Ctrl-x <digit> or click. Max 9 visible/keyable. Per-repo override available via wsx repo set-pinned-commands. |
remotes | Newline-separated list of name=command entries — named shell commands run by wsx remote <name>, typically ssh -t host '…tmux attach…' for reattaching a wsx session running on another machine. List with wsx remote; add or edit with wsx config edit remotes. See Named remote shortcuts. |
dashboard_name_width | Width (chars) of the workspace-name column on the dashboard. Default 24. Clamped to 10..=60. |
dashboard_branch_width | Width (chars) of the ⎇ branch column on the dashboard. Default 28. Clamped to 10..=80. |
detail_bar_config | JSON blob controlling the per-workspace detail bar (visibility, height, and the container/module layout). See Workspace detail bar for the schema, defaults, and per-repo override flow. Out-of-range values are clamped on save. |
chronology_config | JSON blob controlling the change chronology bar in the attached view (visibility, side, and width). See Change chronology for the schema, defaults, and per-repo override flow. |
Value sources:
- A literal string:
wsx config set branch_prefix bakedbean - A file (prefix with
@):wsx config set custom_instructions @./instructions.md - Empty (clears):
wsx config set custom_instructions ""
wsx config edit <key> opens $EDITOR on a tempfile prepopulated with the current value; saving updates the setting. Useful for multi-line custom_instructions.