Skip to content

ui: add projects that share instructions, context and a working directory across chats - #32031

Closed
allozaur wants to merge 23 commits into
ggml-org:masterfrom
allozaur:allozaur/feat/projects
Closed

allozaur wants to merge 23 commits into
ggml-org:masterfrom
allozaur:allozaur/feat/projects

Conversation

@allozaur

@allozaur allozaur commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

Overview

Projects bundle instructions, context and a working directory shared by every chat about the same work, with a Projects page, a page per project, and project chats that open inside their project.

Additional information

Upstream copy of allozaur#28. A project's context offers uploads and referenced files for now; MCP resources come back once the mention picker lists them.

What changed
  • A project holds instructions, context files and a working directory. Its instructions go to the system prompt as written, and the agent can read and edit the chat's own project through project tools.
  • A Projects page reached from the sidebar lists projects, with pinned ones marked and archived ones in their own tab. Each project has a page with its actions, goal and details by its title, and keeps its open chats as tabs.
  • Project chats always open inside their project, under #/projects/<id>/chat/<cid>, where the tab bar leads with the project and shows only its chats. #/projects/<id>/chat/new starts a chat in the project.
  • In the sidebar a project is a row in Pinned, a group or Ungrouped, like a chat, with its chats under it. The chat form shows the chat's project beside its working directory.
  • New chat from a chat now opens a tab of its own instead of turning the chat's tab into the new chat.
  • On phones, the Projects title starts a row below the menu key, and New project is a floating key in the bottom-right corner that slides with the page when the sidebar opens.
Testing
  • npm run check passes on this branch. New client tests cover project tools, the projects database and new-chat tabs, and a unit test covers the project prompt. Lint and the unit and client suites run in CI.
  • On the fork: in a phone viewport, New project is a round key in the bottom-right corner that opens the new project dialog, while the header button stays on desktop. The key keeps 28px from the bottom and the side, beside the home indicator in the installed app, and slides 300px with the page when the sidebar opens, taking no taps while the page is aside. The FloatingActionButton story shows it in a phone viewport.
  • On the fork: from a chat, New chat leaves the chat's tab and adds a new-chat tab, and a project's new chat does the same.

Requirements

@github-actions github-actions Bot added documentation Improvements or additions to documentation server/ui labels Nov 10, 2026
A project's folder shows the same row as a chat's working directory change.
Master draws that row inline in ChatMessageCwdChange; move it into its own
component so both use it.

Assisted-by: Claude (Opus 5.5 Medium)
The projects work as it stood before groups split out of it, kept on top
of groups until it is reworked into its own PR. Not for review.

Projects live in their own IndexedDB table (schema version 3) with a name,
a goal, instructions, context items, a working directory and a hidden
flag, and are configured in one dialog. A new chat in a project starts
from its instructions and context and in its folder. Every visible project
is a sidebar section beside the groups. A chat's menus and the chat form
add it to a project, and a chip under the chat form shows it. Tabs and
pinned chats lead with their project's name, the search dialog lists
projects, and the agent can read and edit them.

A chat in a project shows in the project's section, not its group's.

Assisted-by: Claude (Opus 5.5 Medium)
A Projects action under Search opens a page of project cards, newest
first, with the ones hidden from the sidebar apart below. A card opens the
project dialog, and its right-click menu and "more actions" dropdown edit,
hide or delete the project; New project creates one.

Assisted-by: Claude (Opus 5.5 Medium)
A project is no longer a section of its own: it is a row with its chats
under it, and sits in Pinned, a group or Ungrouped like a chat, moved
there from its menu or by dragging it. A chat dropped on a project joins
it; a chat moved to a group leaves its project. Folding a project
replaces hiding it, so the hidden flag is gone.

Assisted-by: Claude (Opus 5.5 Medium)
The instructions no longer sit under a "You are working in the project"
preamble and an "Instructions for this project:" heading: they go into
the system prompt exactly as the user wrote them. The context list, when
there is one, follows with its own label.

Assisted-by: Claude (Opus 5.5 Medium)
A pinned project's card shows a dimmed pin in its bottom right corner.

Assisted-by: Claude (Opus 5.5 Medium)
The Projects page splits into "Your projects" and "Archived" tabs. Archiving
a project, from its sidebar row or its card, takes it and its chats off the
sidebar and out of the project pickers; restoring it from its card brings
them back where they were.

Assisted-by: Claude (Opus 5.5 Medium)
A project opens on its own page in the chat layout: a breadcrumb with pin, archive, delete and export actions, an editable title, Instructions and Context cards, the project's recent chats and the chat form, all in the chat column. A chat sent from there starts in the project, in the project's working directory. Context takes uploaded files and files or MCP resources picked through the @ picker.

Assisted by: Claude (Opus 5.5 Medium)
Chats opened from a project page live under #/projects/<id>/chat/<cid>, and #/projects/<id>/chat/new starts a chat inside the project. There the tab bar leads with the project breadcrumb and shows only the project's chats, linked inside the project; + opens a new-chat tab of the project. Closing tabs, cycling them and the close shortcut stay within the view. Opening a chat from the sidebar keeps the regular view.

Assisted by: Claude (Opus 5.5 Medium)
The pin and the project menu move from the top corner to the title row,
next to what they act on, and the top bar keeps only the breadcrumb.
The goal is edited in place under the title, like the name, with a
placeholder while it is empty. A details line under it shows the chat
count, when the project was last updated and its working directory.

Assisted by: Claude (Opus 5.5 Medium)
Going back to a project from one of its chats keeps the project's tab
bar, with none of the tabs active and the breadcrumb naming the project
as the current page. The page's own breadcrumb returns once the last
tab closes.

Assisted by: Claude (Opus 5.5 Medium)
A conversation has one home: its project's view when it is in a
project, the regular view otherwise. The sidebar, the search dialog,
the conversation shortcuts, forks and the search page link there
directly, and the chat layout redirects any other way in (an old link,
the back button, a chat moved in or out of a project while open)
without a history entry of its own.

Project chats stay in their project's tab strip, out of the regular
one, so they no longer carry the project name as a prefix there.

Assisted by: Claude (Opus 5.5 Medium)
The card on the Projects page and the + of a project's sidebar row go to
the project's page, where its new chats start, and the row's menu gains
Open project. A chat outside any project no longer shows the project
chip left over from the last project page.

Assisted-by: Claude (Opus 5.5 Medium)
…on phones

Assisted-by: Claude (Opus 5.5 Medium)
… project

Assisted-by: Claude (Opus 5.5 Medium)
…installed app

Assisted-by: Claude (Opus 5.5 Medium)
…the bottom

Assisted-by: Claude (Opus 5.5 Medium)
…er jumps

Assisted-by: Claude (Opus 5.5 Medium)
…ources

The mention picker's MCP resources wait for their own change, so a project's context offers
uploads and referenced files for now. The picker gains the list's own search field and a
bindable query, for a host without an @ token like the project's context.

Assisted-by: Claude (Opus 5.5 Medium)
The update and add-context tools took any project id, so a chat could write
instructions into another project, where they steer every chat. Reading any
project stays possible; edits go to the chat's project only.

Assisted-by: Claude (Opus 5.5 Medium)
…m lands

Assisted-by: Claude (Opus 5.5 Medium)
A project's sidebar row takes the footer's phone sizing and selected-row
look, as conversation rows do, and the Projects action opens its page
behind the phone sidebar like the footer's pages.

Assisted-by: Claude (Opus 5.5 Medium)
@allozaur
allozaur force-pushed the allozaur/feat/projects branch from 7e61a27 to 7a29aaf Compare November 10, 2026 18:04
@allozaur allozaur closed this Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation server/ui

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant