GeezerVison

Copy link

Copy Markdown

Contributor

chatgpt-codex-connector Bot reviewed Oct 24, 2026

View reviewed changes

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

chatgpt-codex-connector Bot reviewed Oct 24, 2026

View reviewed changes

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

jaaydenh added this pull request to stack #31252 October 25, 2026 11:37

jaaydenh marked this pull request as ready for review October 27, 2026 11:44

jaaydenh requested a review from a team as a code owner October 27, 2026 11:44

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:
- #30683 changes project deletion.
- #30754, #30756, and #30898 add project templates.

> Generated by Coder Agents on behalf of @f0ssel.

pr-queue-manager Bot requested a review from DanielleMaywood October 30, 2026 06:20

DanielleMaywood reviewed Oct 30, 2026

View reviewed changes

DanielleMaywood reviewed Oct 30, 2026

View reviewed changes

DanielleMaywood reviewed Oct 30, 2026

View reviewed changes

The chat project ACL response now includes the project's owner, so the
project page can show who owns a project to everyone who can read it.

`GET
/api/experimental/organizations/{organization}/chats/projects/{project}/acl`
returns a new `owner` field (`MinimalUser`). The owner is never in
`users`, and `GET /api/v2/users/{id}` returns 404 to regular
organization members, so project members and project admins currently
see the owner as "Unknown". The handler loads the owner with a
system-restricted context after the existing read and sharing-disabled
checks, matching how it already loads shared users and groups.

`TestChatProjectSharing/User` and `/Admin` now check the owner as seen
by the owner, a `use` sharee and an `admin` sharee, and that both
sharees still get 404 from the users endpoint. Dogfood UAT on a dev
deployment confirmed the field for all three callers, no owner data for
callers without access (404), and the unchanged 403 when chat sharing is
disabled.

Stack (merge bottom first):
- 👉 this PR
- #31245
- #31246
- #31247

Base automatically changed from chat-project-access/members-summary to main November 4, 2026 08:07

Adds a members section to the chat project Details panel and a read-only
"View access" dialog.

- The Details card gets a members section at the bottom: "N members[, G
groups]" (the owner plus directly shared users; groups are counted
separately), a row of avatars with name tooltips, and a "View access"
button. The row shows as many avatars as fit the card's width (up to
eight) and ends with a "+K" tile for the rest; its tooltip lists up to
ten hidden names and "and N more". Member tooltips let clicks through,
so they never block the button.
- The dialog lists the owner first with an Owner badge, then shared
users and groups (sorted naturally by name) with their role. The `use`
role shows as "Member" and `admin` as "Admin". A footnote explains that
chats in the project start private.
- The owner's name and avatar come from the new `owner` field on the ACL
response (#31244), so project members and admins see the real owner in
the "Project owner" row too, instead of "Unknown".
- The section is hidden when chat sharing is disabled (the ACL endpoint
returns 403). Loading shows skeletons; other errors show an alert with
Retry in both the panel and the dialog.
- Adds `getChatProjectACL` to the API client and a `chatProjectACL`
query. Editing access comes in #31246.

Dogfood UAT passed on a dev deployment: owner, `use` and `admin` viewers
all see the owner and the same members list with no users requests,
counts and "+K" overflow are correct, the row fits the card from 320 to
1440px with the sidebar open or collapsed, tooltips never swallow the
button click, the section hides with `--disable-chat-sharing`, and ACL
errors recover with Retry.

| Members section (member's view) | View access dialog |
| --- | --- |
| <img alt="Details panel with the members section, as a project member"
src="https://raw.githubusercontent.com/coder/coder/assets/pr-31245-project-members/pr/members-section.png"
width="600" /> | <img alt="View access dialog listing owner, admin,
member and Everyone"
src="https://raw.githubusercontent.com/coder/coder/assets/pr-31245-project-members/pr/view-access-dialog.png"
width="600" /> |

Stack (merge bottom first):
- #31244
- 👉 this PR
- #31246
- #31247

jaaydenh requested a review from DanielleMaywood November 4, 2026 09:55

DanielleMaywood approved these changes Nov 4, 2026

View reviewed changes

26 of 27 checks passed

jaaydenh deleted the chat-project-access/manage-access branch November 4, 2026 12:49