@gannonh/agent-setup

CLI that copies this repo's Codex, Cursor, and Pi configs into $HOME and runs the matching plugin/skill install scripts, including the Claude Code and Codex pstack plugin (from gannonh/open-pstack).

$ npx @gannonh/agent-setup --help
Install Claude Code, Codex, Cursor, and Pi agent configs, plugins, and skills.

Usage:
  npx @gannonh/agent-setup              Interactive
  npx @gannonh/agent-setup --all        Claude Code, Codex, Cursor, Pi, and skills
  npx @gannonh/agent-setup --claude     Claude Code only
  npx @gannonh/agent-setup --codex      Codex only
  npx @gannonh/agent-setup --cursor     Cursor only
  npx @gannonh/agent-setup --pi         Pi AGENTS.md and extensions
  npx @gannonh/agent-setup --skills     Skills only

Node 20+ on macOS or Linux. npx downloads the package, then the CLI writes under $HOME and runs bash scripts that call claude, codex, git, pi, and npx for the targets you pick.

No flags: it asks Claude Code, Codex, Cursor, Pi AGENTS.md, Pi extensions, then Skills. Each prompt defaults to yes. Pi extensions are a separate prompt from AGENTS.md. If a dest already exists, it lists the files this package would write and asks replace (overwrite those files), append (add this package's content to the end of existing files), or skip.

Flags

npx @gannonh/agent-setup --all
npx @gannonh/agent-setup --claude
npx @gannonh/agent-setup --codex
npx @gannonh/agent-setup --cursor
npx @gannonh/agent-setup --pi
npx @gannonh/agent-setup --skills
npx @gannonh/agent-setup --codex --cursor

--all installs Claude Code, Codex, Cursor, Pi AGENTS.md, Pi extensions, and skills. Target flags can be combined. --pi installs both Pi AGENTS.md and extensions. --skills runs install-skills.sh only, and npx skills add writes into the directory you ran from. Non-interactive flags replace files this package ships and leave other files in the dest directory. While a script runs, the CLI prints what it is doing and a heartbeat every 10s. Pi extensions often take a few minutes.

What it writes

| Target | Script | Copy | | --- | --- | --- | | Claude Code | scripts/install-plugins-claude.sh (claude plugin marketplace add gannonh/open-pstack / claude plugin install pstack@open-pstack) | .claude/CLAUDE.md → ~/.claude/CLAUDE.md | | Codex | scripts/install-plugins-codex.sh (codex plugin marketplace add gannonh/open-pstack / codex plugin add pstack@open-pstack) | .codex → ~/.codex | | Cursor | scripts/install-plugins-cursor.sh (installs each entry in scripts/plugins-cursor.toml: sparse-clones the repo subdirectory into ~/.cursor/plugins/local/<name> and registers it in enabled_plugins in ~/.cursor/settings.json; Cursor has no CLI install command) | .cursor/rules → ~/.cursor/rules | | Pi AGENTS.md | none | .pi/agent/AGENTS.md → ~/.pi/agent/AGENTS.md | | Pi extensions | scripts/install-pi-extensions.sh (pi install for each extension) | none | | Skills | scripts/install-skills.sh (npx skills add ... --copy in the current directory) | none |

To install another Cursor plugin, add a [[plugin]] table (name, repo, path, optional ref) to scripts/plugins-cursor.toml. Restart Cursor after installing.

Replace overwrites the files this package ships. Append concatenates this package's content onto the existing file (or, for directories, onto matching files and copies files that are missing). Skip leaves the dest as-is.

Undo

Codex: codex plugin remove pstack@open-pstack and codex plugin marketplace remove open-pstack. Claude Code: claude plugin uninstall pstack@open-pstack and claude plugin marketplace remove open-pstack; delete ~/.claude/CLAUDE.md if you do not want the copied instructions.

Copied files: delete ~/.codex, ~/.cursor/rules, ~/.pi/agent/AGENTS.md (or the individual files you do not want). Cursor plugins: remove the entry from enabled_plugins in ~/.cursor/settings.json and delete ~/.cursor/plugins/local/<name>. Pi extensions and skills stay until you uninstall them with pi / npx skills.

License

MIT