Agents and access

Wake your agent when you decide

Install the Planpage plugin for Claude Code or Codex so approving a plan, or asking for changes, can wake the agent that wrote it instead of leaving it polling.

For agents: this page as markdown · llms.txt

An agent that asks for your review can't wait for ever: it polls for a few minutes, then gives up and stops. With the Planpage plugin it doesn't have to. It finishes its turn, and when you approve the plan (or ask for changes) you press Send to Claude Code (or Codex), and the session that wrote the plan wakes up and carries on.

Which agents can be woken

Agent Woken by Send to agent?
Claude Code on your computer (terminal, desktop app, IDE) Yes, with the plugin
Codex on your computer (CLI, IDE extension, app) Yes, with the plugin's hooks
Claude Code on the web, Claude Projects threads Yes, through the plan's linked pull request (below)
claude.ai or ChatGPT chats No: nothing can wake a chat. Copy prompt and paste it in

When the agent can't be woken, the button after your decision reads Copy prompt for …: it copies a short message with the plan's link and what to do next.

Claude Code

In Claude Code:

/plugin marketplace add Bifrostdotgg/planpage
/plugin install planpage@planpage
/planpage:connect

/planpage:connect shows a code and opens planpage in your browser; check the code matches and press Connect. Then start a new session. The plugin needs Node 18 or newer.

Codex

Run the Codex setup again; it adds the plugin's hooks when Node is installed:

curl -fsSL https://app.planpa.ge/setup/codex | sh

On Windows: irm https://app.planpa.ge/setup/codex.ps1 | iex. Then run /hooks in Codex once and trust the two Planpage hooks: Codex skips new hooks until you do.

In Codex the wait happens in its Stop hook, so the terminal shows Codex as busy while your plan is in review (up to 50 minutes). Press Esc to stop waiting; the decision is still there for the agent next time.

Cloud sessions and Projects threads

A session running in the cloud can't run the plugin, but it wakes when someone comments on a pull request it's watching. So when the plan has an open pull request linked to it, and planpage's GitHub app is installed on that repository, the button reads Send to Claude Code on PR #12. It posts your decision on the PR as a comment, and the session watching the PR wakes and carries on.

The planpage skill tells cloud agents to link their pull request to the plan (opening a draft one if they have none) and watch it before they stop. The comment holds the plan's title and link, your decision and your note, and everyone who can see the repository can read it.

How it works

  1. When a session starts, the plugin gives the agent a wake key, which it passes to start_session.
  2. When the agent ends its turn with a plan waiting on you, the plugin keeps a connection open to planpage in the background.
  3. After you approve or ask for changes, Send to agent answers that connection, and the plugin wakes the agent with your decision and note. The agent reads the details with get_feedback and carries on.

The review bar shows what happened: Delivered to Claude Code, then Claude Code picked it up once the agent has read your decision. If the agent is in the middle of a turn, it gets the decision when that turn ends.

Anyone who can review the plan can send the decision to the agent that wrote it.

What the plugin can do

The plugin signs in with its own connection, listed under Your account → Agent connections as "Planpage plugin". That connection can only wait for wake-ups: it can't read, publish or change anything, and it doesn't count towards your plan's agent connections. Revoke it there, or run planpage disconnect on the machine.

If it doesn't wake

  • Run node ~/.planpage/planpage.mjs status (Codex) or /planpage:connect again (Claude Code) to check the connection.
  • The agent needs to have started its session after the plugin was connected, and called start_session with its wake key. The planpage skill tells it to.
  • Send to agent only appears for documents an agent wrote, once you've approved them or asked for changes.