Skip to content

Document grok behavior in the README - #33

Merged
caelaxie merged 1 commit into
mainfrom
cursor/readme-grok-behavior-eb54
Oct 26, 2026
Merged

caelaxie merged 1 commit into
mainfrom
cursor/readme-grok-behavior-eb54

Conversation

@caelaxie

Copy link
Copy Markdown
Contributor

Replaces the README sentences that still describe cursor-only behavior. Defaults are grok-4.6 at xhigh, and the panel is grok-4.6 xhigh / grok-4.5 high. /poteto-mode stays off until invoked. Delegates use pstack:poteto-agent and pstack:comment-sicko. deslop, control-cli, and control-ui are bundled. Benny copies to .grok/automations/benny/ and wakes with /loop or scheduler_create.

Closes #29

Open in Web Open in Cursor 

Replace the leftover cursor-only sentences with the grok defaults, spawn types, bundled skills, plan mode, and benny wake the rest of the port already uses.

Co-authored-by: Kaitian Xie <caelaxie@users.noreply.github.com>

@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. readme-only, and every replaced sentence matches #29's smallest fix verbatim (lines 40, 103–105, 214–218, 256–264, 266, 284); author voice and install block untouched. no plugin content touched, so green Validate plugin on 226fbcd is enough proof. Closes #29 present, not a draft. squash-merging.

@caelaxie
caelaxie merged commit eaa3972 into main Oct 26, 2026
1 check passed
@caelaxie
caelaxie deleted the cursor/readme-grok-behavior-eb54 branch October 26, 2026 03:04
@cursor
cursor Bot restored the cursor/readme-grok-behavior-eb54 branch October 26, 2026 03:05
@cursor

cursor Bot commented Oct 26, 2026

Copy link
Copy Markdown

Harness at head 226fbcdc58183fb78ecf929caac9234f62be1c3d, grok 1.0.70 (f50904eaee6c). Isolated HOME.

$ grok --version
grok 1.0.70 (f50904eaee6c)

$ grok plugin validate .
Plugin manifest is valid.
  name: pstack
  version: 0.15.32

$ grok plugin install https://github.com/pstack-ports/grok-pstack@cursor/readme-grok-behavior-eb54 --trust
Installed 1 plugin(s) from https://github.com/pstack-ports/grok-pstack@cursor/readme-grok-behavior-eb54: pstack

$ grok plugin list --json
[{"status":"installed","name":"pstack","version":"0.15.32","source":"https://github.com/pstack-ports/grok-pstack"}]

Installed checkout HEAD is 226fbcdc58183fb78ecf929caac9234f62be1c3d (refs/heads/cursor/readme-grok-behavior-eb54).

grok inspect --json: plugin pstack enabled, 61 skills, every one userInvocable: true and sourced from plugin pstack. Agents include pstack:poteto-agent and pstack:comment-sicko.

Rest of CI, on this head: frontmatter check Validated 61 skills, 2 agents, and 23 playbooks. bash -n on skills/poteto-mode/scripts/worktree-audit.sh and skills/show-me-your-work/scripts/log.sh passed. bun install --frozen-lockfile, bun run typecheck, and bun run test passed (82 pass, 0 fail).

$ grok -p 'say hi' --max-turns 1
Not signed in. Run `grok login` to authenticate (or `grok login --device-code` if no browser is available).
Error: Not signed in. Run `grok login` to authenticate (or `grok login --device-code` if no browser is available).

A live grok -p turn is auth-blocked.

Installed README.md is byte-identical to this head. Installed text of the changed sentences:

that's it. the other skills are situational, and the mode skill uses them for you as needed. out of the box every role defaults to `grok-4.6` at `xhigh`. the default panel is `grok-4.6 xhigh` / `grok-4.5 high`. [`/setup-pstack`](./skills/setup-pstack/SKILL.md) changes any of it.

type `/poteto-mode` at the start of each task. the skill has `disable-model-invocation: true`, so it stays off until you invoke it. there is no custom mode to pin.

[`/poteto-mode`](./skills/poteto-mode/SKILL.md) works with `/loop`. each fire cannot see this chat, so the stored prompt must stand alone.

pstack also ships [`subagent_type: "pstack:poteto-agent"`](./agents/poteto-agent.md) as the wrapper for delegates spawned during a run. it reads `poteto-mode` in full, including its inline principles index, before doing any work. omitting `subagent_type` skips that read and drifts. do not spawn `poteto-agent` to run the playbook itself.

[`/poteto-mode`](./skills/poteto-mode/SKILL.md) and [`subagent_type: "pstack:poteto-agent"`](./agents/poteto-agent.md) route through the same wrapper.

pstack also ships [Comment Sicko](./agents/comment-sicko.md), a read-only comment reviewer available as `subagent_type: "pstack:comment-sicko"`. usually invoke it through [`/no-comments`](./skills/no-comments/SKILL.md), not directly.

`/deslop`, `control-cli`, and `control-ui` are bundled in this plugin. `/create-skill` is a Grok Build skill. `/loop` is a Grok Build built-in. inside `poteto-mode`, pr-status requests go to the [babysit playbook](./skills/poteto-mode/playbooks/babysit.md).

grok build plan mode works alongside pstack. but personally, i don't believe in planning. the best spec is code. if you do want to make a plan, [`/poteto-mode`](./skills/poteto-mode/SKILL.md) covers it, but it's not a default.

to set it up, point grok build at [`FOR_AGENTS.md`](./automations/benny/FOR_AGENTS.md). setup copies the pack into the target repository at `.grok/automations/benny/`, enables pstack there for shared skills, and keeps user configuration outside the copied pack. a live wake is `/loop` or `scheduler_create`, and only when you ask.

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.

audit: readme still documents cursor-only behavior

2 participants