AI Projects

Projects organize AI work around a shared workspace. A project can contain chats and source files, and those source files can be used as context when the assistant answers.

Project code lives inside the AI chat feature because projects are part of the AI workspace, not a separate generic folder system.

What It Includes

• Create, rename, and delete projects.
• Expand and collapse projects in the dashboard sidebar.
• Move chats into and out of projects.
• Open a dedicated project workspace view.
• List project chats with pagination.
• Upload, preview, paginate, and delete project source files.
• Start a new chat from a project workspace.
• Attach the current project to a new chat.
• Use project sources as AI context.

Main Surfaces

The dashboard route owns which project is active. The project UI reads the route state and loads the matching project detail, chats, and sources.

Data Flow

Project API clients live in src/features/ai/chat/api/projects.api.ts.

The main API operations are:

• listProjectsApi
• createProjectApi
• getProjectApi
• listProjectChatsApi
• listProjectSourcesApi
• uploadProjectSourcesApi
• deleteProjectSourceApi
• updateProjectApi
• deleteProjectApi

Project database access lives in src/features/ai/chat/repositories/project.repository.ts.

Client data loading uses feature owned hooks:

• src/features/ai/chat/hooks/use-fetch-projects.ts
• src/features/ai/chat/hooks/use-fetch-project-detail.ts
• src/features/ai/chat/hooks/use-fetch-project-chats.ts
• src/features/ai/chat/hooks/use-fetch-project-sources.ts
• src/features/ai/chat/hooks/use-mutate-create-project.ts
• src/features/ai/chat/hooks/use-mutate-update-project.ts
• src/features/ai/chat/hooks/use-mutate-delete-project.ts
• src/features/ai/chat/hooks/use-mutate-upload-project-sources.ts
• src/features/ai/chat/hooks/use-mutate-delete-project-source.ts

Sources And Context

Project sources are files uploaded directly to a project. They differ from the general Library because they belong to a specific project workspace.

When a chat is connected to a project, project source summaries and extracted source content can be included in assistant context. This lets the user ask project specific questions without attaching the same files to every message.

Storage behavior for project source files is documented in Storage. Context assembly is documented in AI Context.

Where To Customize

• src/features/ai/chat/constants/chat-project.constants.ts for project workspace limits.
• src/features/ai/chat/components/project-workspace for project workspace UI.
• src/features/ai/chat/components/chat-dashboard-sidebar for sidebar project behavior.
• src/features/ai/chat/api/projects.api.ts for browser API calls.
• src/features/ai/chat/repositories/project.repository.ts for database behavior.
• src/features/ai/chat/hooks for query and mutation behavior.

When changing project behavior, keep URL state, sidebar state, project workspace state, and query invalidation aligned so the sidebar and project page update together.