Public: anyone can read this; the crew can change it.
Both plugins gain `/forge preview <url>` and `/forge pulls <app>`: where am I, and what is open #6107
Check · Review · Land · Live done — Landed and live in production.
scout/forge:scout/6089-both-plugins-gain-forge-preview-url-and → main 6 commits fork 1 thread · 1 unresolved
6 files
changed +26
−10
docs/MCP.md +2 −1
| @@ -331,4 +331,5 @@ answers | ||
| 331 | 331 | from `context.page`, which is any http(s) address appended as context, not |
| 332 | 332 | linked as the origin. |
| 333 | 333 | - **Plugins.** `plugins/opencode` and `plugins/claude-code` register this |
| 334 | server and add a `forge` command (tell, status, decide). They hold no logic. | |
| 334 | server and add a `forge` command (tell, status, decide, plan, preview, | |
| 335 | pulls). They hold no logic. |
plugins/claude-code/README.md +6 −1
| @@ -3,8 +3,13 @@ | ||
| 3 | 3 | Set `FORGE_URL` (the forge's address, no trailing slash) and `FORGE_TOKEN` |
| 4 | 4 | (an `rw` token; `ro` reads only; make one at `/settings/tokens` on the forge, which also shows this line filled in), then add this directory as a plugin |
| 5 | 5 | (`claude --plugin-dir plugins/claude-code`). It registers the forge's MCP |
| 6 | server and a `/forge` command: `tell`, `status`, `decide`, `plan`. | |
| 6 | server and a `/forge` command: `tell`, `status`, `decide`, `plan`, `preview`, | |
| 7 | `pulls`. | |
| 7 | 8 | |
| 8 | 9 | `/forge plan` shows the planner's proposed wave in three lines. `/forge plan approve`, `/forge plan redirect <words>` or `/forge plan later` answers it, after you confirm. |
| 9 | 10 | |
| 11 | `/forge preview <url>` says in two lines the app, environment, pull, check | |
| 12 | and who is working at that URL. `/forge pulls <app>` lists the app's open | |
| 13 | pulls with their check. | |
| 14 | ||
| 10 | 15 | `test/plugins.test.ts` fails when this plugin names an MCP tool the forge does not list, so a rename in `src/http/mcp.ts` cannot leave it behind. |
plugins/claude-code/commands/forge.md +4 −2
| @@ -1,6 +1,6 @@ | ||
| 1 | 1 | --- |
| 2 | description: Talk to your forge: tell, status, decide, plan | |
| 3 | argument-hint: tell <app> <words> | status | decide <approve|redirect|decline> [words] | plan [approve|redirect <words>|later] | |
| 2 | description: Talk to your forge: tell, status, decide, plan, preview, pulls | |
| 3 | argument-hint: tell <app> <words> | status | decide <approve|redirect|decline> [words] | plan [approve|redirect <words>|later] | preview <url> | pulls <app> | |
| 4 | 4 | --- |
| 5 | 5 | |
| 6 | 6 | Use the `forge` MCP server's tools for `$ARGUMENTS`. |
| @@ -9,5 +9,7 @@ Use the `forge` MCP server's tools for `$ARGUMENTS`. | ||
| 9 | 9 | - `status`: call `now` and `asks`; say in three sentences what is running and what waits on the person. |
| 10 | 10 | - `decide approve|redirect|decline`: call `asks`, take the first row; approve → `asks_act` with action `ship`, decline → `asks_act` with action `close`, redirect → `say` with the person's words. Plan first (`dryRun` defaults to true), show what would change, and apply (`dryRun: false`) only after the person says yes. |
| 11 | 11 | - `plan`: call `asks`, take the first row whose kind is `proposal` (none: say no wave waits). Show it in three lines: the wave's title, what it holds, why now. With `approve`, `redirect <words>` or `later`, ask the person to confirm, and only after they say yes call `asks_proposal` with `id` = that row's `proposal.id` (the proposal's own id, not the row's `id`, which starts `proposal:`), `verb` = the word, and `words` for redirect. |
| 12 | - `preview <url>`: call `preview` with `url`; say in two lines the app, environment, pull, check and who is working. | |
| 13 | - `pulls <app>`: call `pulls` with `repo` = the app (owner/name); list the open pulls, one line each with its check. | |
| 12 | 14 | |
| 13 | 15 | Keep what you relay short. Never merge: a person lands changes. |
plugins/opencode/README.md +7 −1
| @@ -3,10 +3,16 @@ | ||
| 3 | 3 | Copy `forge.ts` into `.opencode/plugin/` (or list this package under `plugin` |
| 4 | 4 | in `opencode.json`), and set `FORGE_URL` and `FORGE_TOKEN` (make the token at `/settings/tokens` on the forge, which shows the line with its own address filled in): |
| 5 | 5 | `mkdir -p .opencode/plugin && cp plugins/opencode/forge.ts .opencode/plugin/ && FORGE_URL=<url> FORGE_TOKEN=<token> opencode`. It registers the |
| 6 | forge's MCP server and the `forge` command: `tell`, `status`, `decide`, `plan`. | |
| 6 | forge's MCP server and the `forge` command: `tell`, `status`, `decide`, `plan`, | |
| 7 | `preview`, `pulls`. | |
| 7 | 8 | `/forge plan` shows the planner's next wave (the first wave-proposal row of `asks`); |
| 8 | 9 | `/forge plan approve`, `redirect <words>` or `later` steers it through `asks_proposal`, |
| 9 | 10 | applied only after you say yes. Only the owner may act on a proposal. |
| 11 | ||
| 12 | `/forge preview <url>` says in two lines the app, environment, pull, check | |
| 13 | and who is working at that URL. `/forge pulls <app>` lists the app's open | |
| 14 | pulls with their check. | |
| 15 | ||
| 10 | 16 | Code Mode can also read `GET /contract/openapi.json`. |
| 11 | 17 | |
| 12 | 18 | `test/plugins.test.ts` fails when this plugin names an MCP tool the forge does not list, so a rename in `src/http/mcp.ts` cannot leave it behind. |
plugins/opencode/forge.ts +4 −2
| @@ -1,6 +1,6 @@ | ||
| 1 | 1 | /** |
| 2 | 2 | * forge for OpenCode: registers the forge's MCP server and a `forge` |
| 3 | * command (tell, status, decide, plan). Set FORGE_URL and FORGE_TOKEN. | |
| 3 | * command (tell, status, decide, plan, preview, pulls). Set FORGE_URL and FORGE_TOKEN. | |
| 4 | 4 | * No logic lives here: the tools are the forge's own (`docs/MCP.md`). |
| 5 | 5 | */ |
| 6 | 6 | import type { Plugin } from "@opencode-ai/plugin"; |
| @@ -10,6 +10,8 @@ const COMMAND = `Use the forge MCP tools for: $ARGUMENTS | ||
| 10 | 10 | - status: call \`now\` and \`asks\`; say in three sentences what runs and what waits on the person. |
| 11 | 11 | - decide approve|redirect|decline: call \`asks\`; approve -> \`asks_act\` ship, decline -> \`asks_act\` close, redirect -> \`say\`. Plan first, apply (dryRun false) only after the person says yes. |
| 12 | 12 | - plan [approve|redirect <words>|later]: call \`asks\`; show the first wave-proposal row (the planner's next wave) in a few lines. approve|redirect|later -> \`asks_proposal\` with that row's id and verb (redirect carries the words as \`words\`). Say what it will do and apply only after the person says yes. |
| 13 | - preview <url>: call \`preview\` with url; say in two lines the app, environment, pull, check and who is working. | |
| 14 | - pulls <app>: call \`pulls\` with repo; list the open pulls, one line each with its check. | |
| 13 | 15 | Never merge: a person lands changes.`; |
| 14 | 16 | |
| 15 | 17 | export const Forge: Plugin = async () => ({ |
| @@ -27,7 +29,7 @@ export const Forge: Plugin = async () => ({ | ||
| 27 | 29 | }; |
| 28 | 30 | config["command"] = { |
| 29 | 31 | ...config["command"], |
| 30 | forge: { description: "Tell, status, decide or plan on your forge", template: COMMAND }, | |
| 32 | forge: { description: "Tell, status, decide, plan, preview or pulls on your forge", template: COMMAND }, | |
| 31 | 33 | }; |
| 32 | 34 | }, |
| 33 | 35 | }); |
test/plugins.test.ts +3 −3
| @@ -19,7 +19,7 @@ const opencodeText = (): string => { | ||
| 19 | 19 | const backticked = (text: string): string[] => [...text.matchAll(/`([a-z][a-z0-9_]*)`/g)].map((m) => m[1]!); |
| 20 | 20 | |
| 21 | 21 | /** Backticked words that are the server or an argument, not a tool. */ |
| 22 | const NOT_TOOLS = new Set(["forge", "repo", "text", "context", "page", "run", "commit", "said", "action", "ship", "close", "status", "words", "id", "verb", "proposal", "approve", "later"]); | |
| 22 | const NOT_TOOLS = new Set(["forge", "repo", "text", "context", "page", "run", "commit", "said", "action", "ship", "close", "status", "words", "id", "verb", "proposal", "approve", "later", "url"]); | |
| 23 | 23 | |
| 24 | 24 | /** Tools the command text tells the agent to call: every backticked name that is not an argument. */ |
| 25 | 25 | const toolsNamed = (text: string): string[] => [...new Set(backticked(text))].filter((n) => !NOT_TOOLS.has(n)); |
| @@ -32,7 +32,7 @@ for (const [label, text] of [ | ||
| 32 | 32 | ] as const) { |
| 33 | 33 | test(`${label} names only tools the forge has`, () => { |
| 34 | 34 | const named = toolsNamed(text()); |
| 35 | for (const core of ["tell", "now", "asks", "asks_act", "say"]) expect(named).toContain(core); | |
| 35 | for (const core of ["tell", "now", "asks", "asks_act", "say", "preview", "pulls"]) expect(named).toContain(core); | |
| 36 | 36 | expect(named.filter((n) => !tools.has(n))).toEqual([]); |
| 37 | 37 | }); |
| 38 | 38 | } |
| @@ -98,7 +98,7 @@ const verbDiff = (a: string, b: string): { onlyA: string[]; onlyB: string[] } => | ||
| 98 | 98 | |
| 99 | 99 | describe("the two plugin commands offer the same verbs", () => { |
| 100 | 100 | test("Claude Code and OpenCode have the same set", () => { |
| 101 | expect(verbsOf(claudeText())).toEqual(["decide", "plan", "status", "tell"]); | |
| 101 | expect(verbsOf(claudeText())).toEqual(["decide", "plan", "preview", "pulls", "status", "tell"]); | |
| 102 | 102 | expect(verbDiff(claudeText(), opencodeText())).toEqual({ onlyA: [], onlyB: [] }); |
| 103 | 103 | }); |
| 104 | 104 |
new above
offline
The Code Mode sentence on the next line now reads as part of this paragraph. Put a blank line after this one or move it above.