Skip to content

docs(docs): add Coder Agents projects page - #30684

Merged
f0ssel merged 11 commits into
mainfrom
docs-chat-projects
Oct 28, 2026
Merged

f0ssel merged 11 commits into
mainfrom
docs-chat-projects

Conversation

@f0ssel

@f0ssel f0ssel commented Oct 13, 2026 •

Copy link
Copy Markdown
Member

Adds docs/ai-coder/agents/projects.md, a short page for Coder Agents projects, linked under Coder Agents as early access.

The page covers:

  • What a project provides.
  • Ownership: organization-scoped, private to the creator, 100 per user, audited.
  • Creating, editing, and deleting projects.
  • Adding chats to a project: project page, composer picker, Move to project, drag onto a folder, and PATCH /api/v2/chats/{chat}.
  • Instructions, with a link to the existing Project skills section for skills.
  • Memory: tools, behavior, limits, and the API.

It also links extending-agents.md#project-skills to the new page.

The page documents projects as early access with no experiment flag. Merge it only once chat-projects no longer gates the feature. The memory and skill APIs it mentions still live under /api/experimental.

Project sharing is left out until its UI lands (#31246, #31245).

Open PRs that will make parts of this page stale:

Generated by Coder Agents on behalf of @f0ssel.

@github-actions

github-actions Bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

Docs preview

Check off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here.

@linear-code

linear-code Bot commented Oct 21, 2026

Copy link
Copy Markdown

CODAGT-1402

@f0ssel f0ssel changed the title docs(docs): add Coder Agents projects page docs(docs/ai-coder/agents): add Coder Agents projects page Oct 26, 2026
@f0ssel f0ssel changed the title docs(docs/ai-coder/agents): add Coder Agents projects page docs(docs): add Coder Agents projects page Oct 26, 2026
@f0ssel
f0ssel requested a review from nickvigilante October 27, 2026 00:16
@f0ssel
f0ssel marked this pull request as ready for review October 27, 2026 03:08
@jakehwll
jakehwll requested a review from bpmct October 27, 2026 06:54
f0ssel pushed a commit that referenced this pull request Oct 27, 2026
Adds `chat-projects` to `ExperimentsSafe`.

The experiment stays opt-in.
Marking it safe does two things:
- `--experiments='*'` turns it on.
- Coder no longer logs the hidden-experiment warning when it is turned
on by name.

It also allows #30684 to document projects under the content guidelines,
which require docs for safe experiments.

Tests: `go test ./codersdk -run TestExperiments`, `go test ./coderd -run
Test_Experiments`, `go test ./coderd/prometheusmetrics -run Experiment`.

> Generated by Coder Agents on behalf of @f0ssel.

@nickvigilante nickvigilante left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Approved with two comments. Thanks!

Comment thread docs/ai-coder/agents/projects.md Resolved
Comment thread docs/ai-coder/agents/projects.md Resolved
# Conflicts:
#	docs/ai-coder/agents/extending-agents.md
@f0ssel
f0ssel merged commit a135a34 into main Oct 28, 2026
28 checks passed
@f0ssel
f0ssel deleted the docs-chat-projects branch October 28, 2026 16:08
@github-actions github-actions Bot locked and limited conversation to collaborators Oct 28, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants