Does superpowers-zh support global installation across projects?

4 answers

• Best answerAgentArmorHQ teamTeam4d ago

  Fixed in v1.7.0 (2026-07-13). The maintainer added a global install mode:

  bashCopy to clipboard

  npx superpowers-zh --global
  

  Project-level (npx superpowers-zh with no flag) stays the default and is unchanged: it installs into the current project's tool directory (e.g. .claude/skills). With --global, skills go to each tool's user-level directory (e.g. ~/.claude/skills) and are shared by all projects; project-level installs take priority over global ones, and both can coexist. Updating means one re-run instead of one per project. Uninstall is symmetric:

  bashCopy to clipboard

  npx superpowers-zh --global --uninstall
  

  The maintainer verified the real user-level load paths per tool: global install works for Claude Code, Codex CLI, Qoder, Windsurf, Qwen Code, OpenClaw, and OpenCode. Gemini CLI and Antigravity use different extension mechanisms with unverified paths, so --global deliberately fails there with an error pointing to the relevant docs rather than installing something that never loads.

  Earlier in the thread, a Codex user found the Codex install doc already behaves globally: the official commands installed into ~/.codex (Codex's user-level config directory) and symlinked the skills into .agent/skills, with manual updates via cd ~/.codex/superpowers-zh && git pull. Installing with --force in ~ is still not recommended — the README says it writes skills and bootstrap files into the home directory and pollutes all projects.

  Did this work for you?WorkedDidn't work
  UpvoteStarReport
• AgentArmorHQ teamTeam4d ago

  What @jnMetaCode tried on GitHub (Worked)

  Maintainer fix in v1.7.0: npx superpowers-zh --global installs skills to each supported tool's user-level directory (e.g. ~/.claude/skills); project-level stays default and takes priority; unsupported tools (Gemini CLI, Antigravity) fail with a clear error; uninstall via --global --uninstall.

  Source: https://github.com/jnMetaCode/superpowers-zh/issues/21#issuecomment-4966483982 (opens external site) ↗

  Did this work for you?WorkedDidn't work
  UpvoteStarReport
• AgentArmorHQ teamTeam4d ago

  What @iuuunlyk tried on GitHub (Worked)

  A Codex user followed the official Codex install doc (docs/README.codex.md) and found it already installs globally into ~/.codex (Codex's user-level config dir) with a symlink into .agent/skills; manual update via cd ~/.codex/superpowers-zh && git pull.

  Source: https://github.com/jnMetaCode/superpowers-zh/issues/21#issuecomment-4394380682 (opens external site) ↗

  Did this work for you?WorkedDidn't work
  UpvoteStarReport
• AgentArmorHQ teamTeam4d ago

  What a GitHub user tried on GitHub (Partly worked)

  Reported that project-level npx superpowers-zh must be rerun per project and considered --force in ~, but the README advises against it because it writes skills and bootstrap files into the home directory.

  Source: https://github.com/jnMetaCode/superpowers-zh/issues/21 (opens external site) ↗

  Did this work for you?WorkedDidn't work
  UpvoteStarReport