docs: document per-template agents_allowed by ethanndickson · Pull Request #27518 · coder/coder · GitHub
Skip to content

docs: document per-template agents_allowed - #27518

Merged
ethanndickson merged 5 commits into
mainfrom
feat-docs-agents-allowed
Aug 7, 2026
Merged

docs: document per-template agents_allowed#27518
ethanndickson merged 5 commits into
mainfrom
feat-docs-agents-allowed

Conversation

@ethanndickson

@ethanndickson ethanndickson commented Jul 27, 2026

Copy link
Copy Markdown
Member

Relates to CODAGT-713

Depends on #27517

This updates the Coder Agents platform controls documentation for the per-template agents_allowed model. It replaces the deployment-wide allowlist instructions with the Agents allowed controls in AI Settings and template settings, documents that templates allow agents by default, and explains that disabled templates are excluded from list_templates, read_template, and create_workspace.

This is the final PR in the stack and aligns the template routing and optimization guidance with the database, API, frontend, cleanup, and CLI changes in the preceding PRs.

@github-actions

github-actions Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

@linear-code

linear-code Bot commented Jul 27, 2026

Copy link
Copy Markdown

CODAGT-713

@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from a7dc590 to 6ecd825 Compare July 27, 2026 10:47
@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch 2 times, most recently from 1566142 to 8c4f1a7 Compare August 3, 2026 05:12
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from 6ecd825 to 2f26107 Compare August 3, 2026 05:12
@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch from 8c4f1a7 to aa24328 Compare August 3, 2026 06:39
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from 2f26107 to 0ed9ad4 Compare August 3, 2026 06:39
@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch from aa24328 to f0b481e Compare August 3, 2026 08:41
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch 2 times, most recently from 0f5dfbb to 0d9baa4 Compare August 4, 2026 04:28
@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch from f0b481e to 16898ca Compare August 4, 2026 04:28
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from 0d9baa4 to bac7176 Compare August 4, 2026 06:20
@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch from 16898ca to 6d0c321 Compare August 4, 2026 06:20
@ethanndickson
ethanndickson marked this pull request as ready for review August 4, 2026 06:25

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bac71765cd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/ai-coder/agents/platform-controls/template-optimization.md Outdated
@coderagents

coderagents Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Documentation Check

This PR is the docs update for the per-template agents_allowed model, and the prose is a solid replacement for the old allowlist language. Two of the bolded UI labels didn't match the actual interface introduced by the earlier PRs in this stack; both are now fixed.

Updates Needed

  • docs/ai-coder/agents/platform-controls/template-optimization.md - The "Agents allowed" toggle wording was corrected. Step 2 now reads "In the New workspaces column, toggle the switch for each template.", matching the column in TemplatesPageView.tsx.
  • docs/ai-coder/agents/platform-controls/template-optimization.md - The settings-page label is now quoted correctly as "Allow Coder Agents to create workspaces with this template" (TemplateSettingsForm.tsx).

Consistency note (optional)

  • docs/ai-coder/agents/platform-controls/index.md and docs/ai-coder/agents/tools/index.md - Both now reference the New workspaces column, and index.md uses the full settings-page label "Allow Coder Agents to create workspaces with this template", aligning with the actual UI.

All previously flagged items are addressed; the docs now match the shipped UI labels.


Automated review via Coder Agents

@ethanndickson

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8f8426f331

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/ai-coder/agents/platform-controls/index.md Outdated
@ethanndickson

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Delightful!

Reviewed commit: 0e653dfe6e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch from 6d0c321 to b9dafe7 Compare August 4, 2026 13:54
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from 0e653df to 5937c5f Compare August 4, 2026 13:54
@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch from 05bcec7 to 31eaab0 Compare August 5, 2026 08:35
@ethanndickson

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from ced4aac to ca9a266 Compare August 5, 2026 09:50
@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch from 31eaab0 to 3b6242e Compare August 5, 2026 09:50
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from ca9a266 to 5a62fbf Compare August 5, 2026 13:24
@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch 2 times, most recently from b0af512 to a2c28d7 Compare August 6, 2026 03:31
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from 5a62fbf to 0207dd0 Compare August 6, 2026 03:31
@ethanndickson ethanndickson changed the title docs(docs/ai-coder/agents/platform-controls): document per-template agents_allowed docs: document per-template agents_allowed Aug 6, 2026
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from 0207dd0 to fd66739 Compare August 6, 2026 03:51
@ethanndickson
ethanndickson force-pushed the feat-cli-template-agents-allowed branch from a2c28d7 to 4ac5d4d Compare August 6, 2026 03:51
ethanndickson added a commit that referenced this pull request Aug 6, 2026
Relates to CODAGT-713

Depends on #27284

This makes the per-template `agents_allowed` field authoritative in the API and chatd. It adds optional create and metadata update fields with the intended default and omission semantics, supports `agents-allowed:` template search, includes the value in telemetry, and makes `list_templates`, `read_template`, and `create_workspace` read the template row directly. Existing-workspace retries remain idempotent, and blocked same-organisation templates return an actionable message.

The experimental `/template-allowlist` routes remain temporarily because the shipped AI Settings page still calls them, but they no longer control chatd enforcement. #27514 moves that page to per-template metadata, #27515 removes the legacy storage, routes, SDK types, and utility, #27517 adds the CLI flags, and #27518 updates the platform controls documentation for the per-template model, directly addressing CRF-5 and CRF-6. The stack is intended to merge as a unit.
@ethanndickson
ethanndickson changed the base branch from feat-cli-template-agents-allowed to graphite-base/27518 August 6, 2026 04:36
ethanndickson added a commit that referenced this pull request Aug 6, 2026
Relates to CODAGT-713

Depends on #27515

This adds `--agents-allowed` to `coder templates create` and `coder templates edit`. Template creation defaults the option to true, matching the per-template API and database default, while template editing only changes the value when the flag is explicitly supplied so unrelated edits preserve the existing setting.

The generated CLI help and reference documentation include the new option. #27518 updates the Coder Agents platform controls documentation to describe the completed per-template model.
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from fd66739 to bce8b72 Compare August 6, 2026 04:46
@graphite-app
graphite-app Bot changed the base branch from graphite-base/27518 to main August 6, 2026 04:46
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from bce8b72 to c747b5a Compare August 6, 2026 04:46

@nickvigilante nickvigilante left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Approved with a few changes. Great work! :shipit: 🚀

Comment thread docs/ai-coder/agents/platform-controls/template-optimization.md Outdated
Comment thread docs/ai-coder/agents/platform-controls/index.md Outdated
Comment thread docs/ai-coder/agents/platform-controls/template-optimization.md Outdated
Comment thread docs/ai-coder/agents/platform-controls/template-optimization.md Outdated
Comment thread docs/ai-coder/agents/platform-controls/template-optimization.md Outdated
@ethanndickson
ethanndickson force-pushed the feat-docs-agents-allowed branch from c747b5a to 850b0e3 Compare August 7, 2026 07:03
@ethanndickson
ethanndickson merged commit ee49107 into main Aug 7, 2026
30 of 31 checks passed
@ethanndickson
ethanndickson deleted the feat-docs-agents-allowed branch August 7, 2026 07:23
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 7, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants