Skip to content

Fix pstack installation guidance for Codex CLI - #48

Merged
caelaxie merged 2 commits into
mainfrom
fix/codex-plugin-install-help
Nov 18, 2026
Merged

caelaxie merged 2 commits into
mainfrom
fix/codex-plugin-install-help

Conversation

@caelaxie

Copy link
Copy Markdown
Contributor

The pstack help skill directed new Codex users to /add-plugin pstack, which Codex CLI rejects. Update the setup instructions to add the marketplace and install the plugin from a terminal, then start a fresh Codex session and invoke the namespaced setup skill.

I ran both documented commands with Codex CLI 0.170.0 in an empty temporary Codex home. The marketplace cloned successfully, and codex plugin list reported pstack 0.15.43 installed and enabled.

@caelaxie caelaxie left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

changes requested (posted as a comment, since github won't let this account request changes on its own pr).

close. the install fix and $pstack: names are needed for codex, and plugin-install ci is green on 3b3c015. one unneeded divergence blocks it:

  • upstream's "Installing changes nothing until the user invokes a skill. Only /setup-pstack loads from the user's words." was dropped. it still holds in codex: poteto-help and poteto-mode set allow_implicit_invocation: false in agents/openai.yaml, setup-pstack has no such file. keep the sentence and only swap the skill name.

no issue to link, so linkage is n/a. not a draft.

Comment thread .agents/skills/poteto-help/SKILL.md Outdated
2. Start a new Codex session in your project and run [`$pstack:setup-pstack`](../setup-pstack/SKILL.md). It asks for a reasoning budget, maps a model to each role, and writes a rule. The rule applies to new chats. Then it offers once each to generate a verification skill and a formal verification skill for the project, unless the project already has one.
3. Start a real task with `$pstack:poteto-mode`, a goal, and a check that can pass or fail.

The [README](../../../README.md) and [guide page 1](../../../docs/guide/01-setup.md) have the details. Offer to word their first prompt with them, per [`references/prompting.md`](references/prompting.md).

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

restore the dropped upstream sentence, renaming only the skill:

Suggested change
The [README](../../../README.md) and [guide page 1](../../../docs/guide/01-setup.md) have the details. Offer to word their first prompt with them, per [`references/prompting.md`](references/prompting.md).
Installing changes nothing until the user invokes a skill. Only `$pstack:setup-pstack` loads from the user's words. The [README](../../../README.md) and [guide page 1](../../../docs/guide/01-setup.md) have the details. Offer to word their first prompt with them, per [`references/prompting.md`](references/prompting.md).

Installing still changes nothing until a skill is invoked, and only
$pstack:setup-pstack loads from the user's words.

Co-authored-by: Kaitian Xie <[email protected]>
@cursor

cursor Bot commented Nov 18, 2026

Copy link
Copy Markdown

codex 0.170.0, 61 skills (poteto-help and setup-pstack present), .agents byte-match ok, sha bf58288. skill run unverified (401).

@caelaxie caelaxie left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pass on bf58288.

the only delta since review 5955267202 is the requested restore in .agents/skills/poteto-help/SKILL.md line 49:

Installing changes nothing until the user invokes a skill. Only $pstack:setup-pstack loads from the user's words.

nothing else changed. install ci is green on this head (https://github.com/pstack-ports/codex-pstack/actions/runs/44291743100/job/134758396685). proof comment 6976747337 matches this sha: codex 0.170.0, 61 skills, .agents byte-match. the skill-run 401 is an auth block, not a failed install. not a draft.

squash-merging.

@caelaxie
caelaxie merged commit 151a93e into main Nov 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants