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, load the wsx skill, report status with wsx status set, and maintain the workspace recap with wsx recap set (see Project manager digest). 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: claude (default) / pi / hermes / codex. Per-workspace override via wsx workspace create <repo> --agent <agent>. 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. |
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_branch_width | Width (chars) of the ⎇ branch column on the dashboard. Default 28. Clamped to 10..=80. |
dashboard_pr_width | Width (chars) of the PR chip column (⏺ #123 open) on the dashboard. Default 16. Clamped to 8..=24. |
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.