Ralph Specum Switch

This is a utility for teams using Ralph Specum in Codex who need to jump between different specification documents. It reads your local config to find all spec directories, then switches the active spec by updating a `.current-spec` file in your default specs root. The implementation is thoughtful about ambiguity, it won't guess if the same spec name exists in multiple roots, and it gives you a summary of phase and approval state after switching. If you're managing multiple specs in a project and tired of manually tracking which one you're working on, this handles the bookkeeping. It's narrow in scope but does one thing cleanly.

GitHub stars: 340
last updated: May 19, 2026

View on GitHub

Install

$ npx -y skills add tzachbon/smart-ralph --skill ralph-specum-switch --agent claude-code

Installs into .claude/skills of the current project.

Files

Ralph Specum Switch

Use this to switch the active spec.

Derive RALPH_CODEX_PLUGIN_ROOT from this loaded skill by resolving two parent directories from the SKILL.md directory. Never derive it from the project working directory.