Skip to content

Roll out Open Pstack 1.5.0 to Claude Code and Codex on the Mac and studio2 #89

Description

@ericlitman

Goal

Move both of Eric's hosts (this Mac and studio2) to the released Open Pstack 1.5.0 in Claude Code and Codex. Bring the Codex model sheet in line with it. Eric answers the setup prompts.

Depends on

#88 must be merged, with v1.5.0 tagged and the release published.

Known installed state (verified 2026-09-24; both hosts identical)

  • Claude Code runs pstack@open-pstack 1.4.1 from the GitHub marketplace (main at de67e6b). There is no ~/.claude/pstack-models.md, so it runs the first-run defaults. Updating therefore changes behavior with no prompt:
    • Judgment and prose, hardest tasks and the How explainer move from Fable max to Opus max.
    • Panels move from Fable/Sol/Grok 4.6/Opus xhigh to Opus max/Sol max/Grok 4.7 xhigh.
    • Feature/refactoring, the How explorer and swarm workers move from Grok 4.6 to 4.7.
    • Bug-fix, perf-issue and hillclimb stay on Sol max. Why and Reflect stay on inherit-parent.
  • Legacy plugin. pstack@pstack-claude 0.9.11 is installed. It is set to false in ~/.claude/settings.json on the Mac.
  • Codex has [marketplaces.open-pstack] ref = "v1.2.1" in ~/.codex/config.toml, with cached plugin 1.2.1.
    • There is no ~/.codex/pstack-models.md. The model rows live only in the bounded <!-- pstack:models:begin --> … <!-- pstack:models:end --> block of ~/.codex/AGENTS.md. Setup reads the sheet file and, when it is missing, starts from the first-run defaults, so step 3 below seeds it first.
    • The rows use all four families at xhigh (fable, sol, grok:grok-4.6, opus), Sol xhigh on bug-fix/perf-issue/hillclimb, and a retired how critics row.
    • Moving to 1.5.0 also brings the 1.3.0-1.4.1 changes: forge-neutral shipping, How critics retired, rolling aliases.

Steps (this Mac first, then studio2)

  1. Update Claude Code. Run claude plugin marketplace update open-pstack, then update pstack@open-pstack (with claude plugin update pstack@open-pstack or /plugin). Restart and confirm it reports 1.5.0.
    • On studio2, check that pstack@pstack-claude is false in ~/.claude/settings.json. If it is true, ask Eric before disabling it.
    • Write no Claude sheet unless Eric chose to keep Fable. In that case, run /pstack:setup-pstack and change only the roles he names.
  2. Back up Codex. Copy ~/.codex/config.toml and ~/.codex/AGENTS.md to *.bak-1.2.1 alongside the originals.
  3. Seed the sheet file. Write the exact bytes between the begin and end marker lines of ~/.codex/AGENTS.md (markers excluded) to ~/.codex/pstack-models.md. That file is setup's documented source of truth.
  4. Upgrade Codex. In ~/.codex/config.toml, change ref = "v1.2.1" under [marketplaces.open-pstack] to ref = "v1.5.0". Run codex plugin marketplace upgrade open-pstack, then codex plugin add pstack@open-pstack, and confirm ~/.codex/plugins/cache/open-pstack/pstack/1.5.0 exists. (codex plugin marketplace add only adds sources; it does not re-point an existing one.)
  5. Rerun setup in Codex. Run pstack:setup-pstack from a Codex session that can reach the Grok CLI (see PR docs(dispatch): note that Grok lanes need an unsandboxed Codex parent #82).
    • It lists how critics as dropped.
    • It reports the grok:grok-4.6 rows for replacement. Answer Grok family, which gives grok:grok-4.7.
    • The role question follows Eric's decision: keep the four-family panel, or change the panels and the judgment/prose, hardest-tasks and How-explainer roles to the new defaults.
    • It asks one effort question per assigned family. The probes pass.
    • Confirm. Setup writes the sheet and the bounded block and runs its smoke.
  6. Smoke Claude Code. Run /pstack:interrogate in Claude Code on a one-file scratch diff and note the lanes. Codex needs no extra smoke; setup's own step 9 already ran a mixed panel there.
  7. Record the results as one issue comment per host: installed versions, the Codex sheet diff (diff <(sed -n '/pstack:models:begin/,/pstack:models:end/p' ~/.codex/AGENTS.md.bak-1.2.1 | sed '1d;$d') ~/.codex/pstack-models.md), and the smoke results.

Rollback

  • Codex: restore the two .bak-1.2.1 files, delete ~/.codex/pstack-models.md, then run codex plugin marketplace upgrade open-pstack and codex plugin add pstack@open-pstack.
  • Claude Code: ship a fix release, or load a v1.4.1 checkout with claude --plugin-dir until one ships.

Out of scope

  • No repository changes and no new tooling.
  • Do not uninstall or disable any plugin without Eric's OK.

Acceptance

On both hosts:

  • Claude Code reports pstack@open-pstack 1.5.0, and interrogate runs the trio (or Eric's chosen roles).
  • Codex reports 1.5.0. Its sheet and AGENTS.md block match and contain no how critics or grok-4.6 rows. Setup's probes and smoke passed.
  • The evidence is recorded on this issue.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions