Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions changes/docs-mcp-ask-runs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
### Added

- **A new CLI's README says that over MCP `ask` does not ask.** A CLI with an api group gets one paragraph beside
the MCP setup: the agent runs the API's writes and deletes, each one is kept in `runs list`, and
`config set permissions.api readonly` or `permissions.api.<operation> deny` stops them for a profile.
10 changes: 10 additions & 0 deletions kit/src/new.ts
Original file line number Diff line number Diff line change
Expand Up @@ -598,6 +598,16 @@ export const cliReadme = (names: Names, facts: ReadmeFacts): string => {
`until you review its permissions and pass \`--allow-writes\`. \`${cli} personal mcp config\` prints the setup for`,
"any other MCP client.",
"",
...(facts.api
? [
// NEED-2731 B: `ask` stays the default for the api group's deletes; over MCP nobody answers it, so say so.
"Over MCP nobody is there to answer `ask`, so the agent runs the API's writes and deletes without asking. Each",
`one is kept as a run in \`${cli} personal runs list\`. To stop that, make the profile read-only with`,
`\`${cli} personal config set permissions.api readonly\`, or refuse one operation with`,
`\`${cli} personal config set permissions.api.<operation> deny\`. \`${cli} api list\` names the operations.`,
"",
]
: []),
"## What it can do",
"",
"[docs/commands.md](docs/commands.md) lists every command, and `--help` after any of them shows its flags.",
Expand Down
10 changes: 10 additions & 0 deletions kit/test/preset.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,16 @@ describe("the new CLI's README", () => {
expect(existsSync(join(dir, `docs/${page}.md`))).toBe(true)
}
for (const block of readme.match(/```sh\n[\s\S]*?```/g) ?? []) expect(block).not.toMatch(/<[a-z]/)
expect(readme).not.toContain("permissions.api")
})

it("says that over MCP ask runs the api group's writes, and how to stop them, when the CLI has one", async () => {
const { dir } = await makeGeneric({ owner: "example", spec: "openapi" })

const readme = read(dir, "README.md")
expect(readme).toContain("Over MCP nobody is there to answer `ask`, so the agent runs the API's writes and deletes")
expect(readme).toContain("`acme personal config set permissions.api readonly`")
expect(readme).toContain("`acme personal config set permissions.api.<operation> deny`")
})
})

Expand Down
Loading