cc-switch-mode

Switch Claude Code work modes (GSD, gstack, Superpowers, OMC, Oh My IPD, OpenSpec) with isolated local installs — from your real project directory.

Not a provider switcher. For API/model/MCP provider management, see cc-switch.

中文 · README.zh.md

cc-gsd      # GSD planning/execution workflow
cc-gstack   # gstack ship/review/browse skills
cc-sp       # Superpowers methodology
cc-omc      # Oh-My-ClaudeCode agents
cc-ipd      # Oh My IPD virtual PDT workflow
cc-os       # OpenSpec proposal/spec workflow

Why cc-switch-mode?

	cc-switch	cc-switch-mode (this repo)
Switches	Provider / API / harness config	Methodology / framework per session
Question	“Which backend powers Claude?”	“Which workflow am I in?”
Examples	Opus vs Sonnet, relay, MCP presets	GSD planning, gstack ship/review, IPD PDT flow, OpenSpec specs, Superpowers coding

Quick Start

git clone https://github.com/hatewx/cc-switch-mode.git
cd cc-switch-mode
./install.sh
source .bash_aliases

cd ~/my-project
cc-gsd

Modes

Alias	Mode	Upstream
cc-gsd	GSD	open-gsd/get-shit-done-redux
cc-gstack	GStack	garrytan/gstack
cc-sp	Superpower	obra/superpowers
cc-omc	oh-my-claudecode	yeachan-heo/oh-my-claudecode
cc-ipd	Oh My IPD	hatewx/oh-my-ipd
cc-os	OpenSpec	Fission-AI/OpenSpec

How it works

cd ~/my-project
cc-<mode>  →  launch.sh  →  claude --add-dir <mode>/ …

Mechanism	Role
cwd	Your project (pwd or CC_SWITCH_MODE_WORK_DIR)
--add-dir	Mounts <mode>/ (skills, files)
--plugin-dir	Superpower & OMC (vendor/)
--settings	Mode hooks / auto-memory from mode .claude/
User settings	~/.claude and project .claude load as usual
GSD / Superpower	Symlinks commands / hooks into project .claude/

Do not run cc-* from inside gsd/, gstack/, etc.

What you should see

Run a mode from your real project directory:

cd ~/my-project
cc-gsd

launch.sh starts Claude Code with the selected mode directory mounted through --add-dir. GSD and Superpower also link their project-discoverable assets into ~/my-project/.claude/ on first run, so slash commands, hooks, and agents are available where Claude Code expects them.

See assets/README.md for the screenshot and recording checklist used by the README.

Install locally

./install.sh              # all modes
./install.sh oh-my-ipd    # one mode
./verify-install.sh

Mode	Install target
gsd	gsd/.claude/ via npx @opengsd/get-shit-done-redux --claude --local
gstack	gstack/.claude/skills/gstack + ./setup
superpower	superpower/vendor/superpowers
oh-my-claudecode	oh-my-claudecode/vendor/oh-my-claudecode
oh-my-ipd	oh-my-ipd/vendor/oh-my-ipd
openspec	openspec/.claude/ via openspec init

Large vendored trees are gitignored; run install.sh after clone.

Shell setup

source /path/to/cc-switch-mode/.bash_aliases
export CC_SWITCH_MODE_ROOT=/path/to/cc-switch-mode   # optional

CC_SWITCH_MODE_ROOT is set when you source the aliases file.

Permission safety

All modes default to --permission-mode acceptEdits. --dangerously-skip-permissions is intentionally not a default because it lets Claude Code run tools without normal confirmation prompts, which can edit files, run commands, or damage a real workspace faster than you can review.

If you still want that behavior, opt in explicitly:

CC_SWITCH_MODE_UNSAFE_SKIP_PERMISSIONS=1 cc-gsd

Use this only in disposable local workspaces or after reviewing the command and data-loss risk.

Third-party notice

GSD, gstack, Superpowers, oh-my-claudecode, Oh My IPD, and OpenSpec are independent projects. This repository is an unofficial launcher and installer. Trademarks belong to their owners.

Documentation

• CONTRIBUTING.md
• SECURITY.md
• INIT-STEP.md — bootstrap notes

License

MIT — see LICENSE.