workspace: Add `.code-workspace` file support by coopbri · Pull Request #46225 · zed-industries/zed

coopbri · 2026-01-07T03:25:30Z

Added basic .code-workspace file support. Opening workspace files loads all folders defined in the folders array with CLI support, recent projects integration, and session persistence.

Deferred for future PRs (pending community/Zed team discussion):

VS Code settings translation (currently, workspace settings ignored)
- Also name field parsed but unused
- extensions field ignored
Reload/watch on external changes
The big one: native .zed-workspace (or similar naming) support
- I added structure for it in WorkspaceFileKind enum, but not implemented

Note: It seems multi-root git status only shows first repository (pre-existing limitation, not introduced here).

zed-workspaces.mp4

Release Notes:

Added support for opening .code-workspace files

Test Steps:

Create a .code-workspace file (note: as above, currently only folders array is processed), e.g.:

{
  "folders": [
    {
      "name": "Bevy",
      "path": "../bevy"
    },
    {
      "name": "Zed",
      "path": "."
    }
  ]
}

Then, options:

Open from terminal: zed demo.code-workspace
Open from File -> Open picker (or Open Recent picker if in recents)
Drag and drop the .code-workspace file onto the Zed window
OS native open (with file association)

cla-bot · 2026-01-07T03:25:33Z

We require contributors to sign our Contributor License Agreement, and we don't have @coopbri on file. You can sign our CLA at https://zed.dev/cla. Once you've signed, post a comment here that says '@cla-bot check'.

coopbri · 2026-01-07T03:28:43Z

@cla-bot check

cla-bot · 2026-01-07T03:28:47Z

The cla-bot has been summoned, and re-checked this pull request!

zed-industries-bot · 2026-01-29T14:05:01Z

	Warnings
⚠️	This PR is missing release notes. Please add a "Release Notes" section that describes the change: `Release Notes: - Added/Fixed/Improved ...` If your change is not user-facing, you can use "N/A" for the entry: `Release Notes: - N/A`

Generated by 🚫 dangerJS against 70504ce

coopbri · 2026-02-08T07:37:31Z

Warnings
⚠️
This PR is missing release notes.

Please add a "Release Notes" section that describes the change:
Release Notes:

- Added/Fixed/Improved ...
If your change is not user-facing, you can use "N/A" for the entry:
Release Notes:

- N/A
Generated by 🚫 dangerJS against 69c9e33

No it is not

g5becks · 2026-02-10T15:48:48Z

Is this feature going to support extension recommendations like vscode?

rxmarbles · 2026-02-18T07:12:09Z

@coopbri looks like the windows test suite failed, possibly in relation to upstream changes. might have to address conflicts as well. Look forward to seeing this feature get deployed. Its the one thing to help reduce my need for so many open windows 😂

coopbri · 2026-02-18T15:24:14Z

@coopbri looks like the windows test suite failed, possibly in relation to upstream changes. might have to address conflicts as well. Look forward to seeing this feature get deployed. Its the one thing to help reduce my need for so many open windows 😂

Yeah I was getting sick of resolving conflicts until hearing back from someone 😂 Will fix today.

# Conflicts: # crates/recent_projects/src/recent_projects.rs # crates/workspace/src/persistence.rs # crates/workspace/src/workspace.rs # crates/zed/src/main.rs # crates/zed/src/zed/open_listener.rs

coopbri · 2026-02-18T16:00:37Z

Is this feature going to support extension recommendations like vscode?

I think this is a cool idea, but best scoped for another PR. That way we can incrementally adopt the workspace support with atomic feature branches.

coopbri · 2026-02-18T16:01:36Z

@rxmarbles we cookin now! Thanks for bringing that to my attention.

# Conflicts: # crates/workspace/src/workspace.rs

Apply cargo fmt fixes to recent_projects and persistence crates, and use path! macro in workspace file tests so paths include the drive letter on Windows.

laris · 2026-02-28T13:26:25Z

I create a hooked version to manage *.code-workspace and sync with internal sqlite3 workspace_id

laris/zed-project-workspace: Zed workspace sync hook + MCP tools powered by dylib-kit

it can sync the workspace_id with *.code-workspace via .zed/settings.json project_name variable
it can pin the project_name/primary workspace folder name in top of projects pannel entries list
can pin in the zed's menu bar picker list
can pin in the search/open rencent project list

Syncs the .code-workspace PR (zed-industries#46225) with main (3494 commits ahead). Upstream landed a "project groups" / multi-workspace feature that restructured the same surfaces this PR touches, so the merge re-integrates the .code-workspace support into that refactor: - Kept the LocalFromFile location variant + workspace_file_source OpenOptions field alongside upstream's identity_paths, dev-container, and project-group additions. - recent_projects: moved the .code-workspace open path into upstream's extracted open_recent_projects(); LocalFromFile treated as local across the picker/sidebar. - persistence: unioned workspace_file_path/kind with identity_paths across the save/read queries (nested the args tuple within sqlez's 10-element Bind limit), and moved the workspace_file_* migration to the end of the list so existing users' applied-migration indices are preserved. - open_listener/main: threaded workspace_file_source through the CLI open path; added LocalFromFile arms to the match sites the project-groups feature added. Verified: `cargo check -p zed` clean (no warnings in touched files); `cargo test -p workspace -p recent_projects --lib` = 308 passed, 0 failed (incl. all 44 persistence round-trip tests).

feature(workspace): add code workspace file construct

d132d42

coopbri mentioned this pull request Jan 7, 2026

Support opening .code-workspace files to open vs code type workspace directly #9459

Open

1 task

cla-bot Bot added the cla-signed The user has signed the Contributor License Agreement label Jan 7, 2026

maxdeviant changed the title ~~[WIP] feature(workspace): add code workspace file construct~~ workspace: Add .code-workspace file support Jan 7, 2026

coopbri added 10 commits January 7, 2026 13:25

feature(persistence): add workspace file tracking

c6ea7b3

feature(workspace): add workspace file support

0861d69

feature(workspace,welcome): add workspace file selector to welcome

0ac28c2

feature(recent-projects): add workspace file support

f90c529

feature(main): add workspace file support

fa3afc5

feature(open-listener): add workspace file support

313caaa

fix(open-listener): properly instantiate path buffers

03f4ad4

Merge remote-tracking branch 'upstream/main' into feature/code-workspace

f7f57f1

fix(main): unwrap Result before awaiting Task

ffe2b02

fix(main): await Task

3ce66d2

coopbri marked this pull request as ready for review January 10, 2026 18:56

Merge remote-tracking branch 'origin/main' into feature/code-workspace

69c9e33

coopbri added 3 commits February 7, 2026 23:39

Merge remote-tracking branch 'upstream/main' into feature/code-workspace

c7692db

chore: format

a99014a

fix(zed,open-listener): correct call args

61d3752

Merge remote-tracking branch 'origin/main' into feature/code-workspace

7556468

# Conflicts: # crates/recent_projects/src/recent_projects.rs # crates/workspace/src/persistence.rs # crates/workspace/src/workspace.rs # crates/zed/src/main.rs # crates/zed/src/zed/open_listener.rs

coopbri requested review from a team as code owners February 18, 2026 15:59

coopbri added 3 commits February 18, 2026 15:14

Merge remote-tracking branch 'origin/main' into feature/code-workspace

ccada00

# Conflicts: # crates/workspace/src/workspace.rs

Merge branch 'main' into feature/code-workspace

1861d8f

# Conflicts: # crates/workspace/src/workspace.rs

fix: resolve formatting and Windows test failures

70504ce

Apply cargo fmt fixes to recent_projects and persistence crates, and use path! macro in workspace file tests so paths include the drive letter on Windows.

SomeoneToIgnore assigned ConradIrwin Mar 24, 2026

ConradIrwin assigned mikayla-maki and unassigned ConradIrwin Mar 25, 2026

SomeoneToIgnore removed request for a team April 8, 2026 07:28

smitbarmase added the area:workspace Feedback for workspace management, layout, interactions, etc label Jun 29, 2026

coopbri and others added 2 commits July 17, 2026 17:37

Merge branch 'main' into feature/code-workspace

7d6543b

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

workspace: Add `.code-workspace` file support#46225

workspace: Add `.code-workspace` file support#46225
coopbri wants to merge 21 commits into
zed-industries:mainfrom
coopbri:feature/code-workspace

coopbri commented Jan 7, 2026 •

edited

Loading

Uh oh!

cla-bot Bot commented Jan 7, 2026

Uh oh!

coopbri commented Jan 7, 2026

Uh oh!

cla-bot Bot commented Jan 7, 2026

Uh oh!

zed-industries-bot commented Jan 29, 2026 •

edited

Loading

Uh oh!

coopbri commented Feb 8, 2026

Uh oh!

g5becks commented Feb 10, 2026

Uh oh!

rxmarbles commented Feb 18, 2026

Uh oh!

coopbri commented Feb 18, 2026

Uh oh!

coopbri commented Feb 18, 2026

Uh oh!

coopbri commented Feb 18, 2026

Uh oh!

laris commented Feb 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

Uh oh!

Uh oh!

Conversation

coopbri commented Jan 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cla-bot Bot commented Jan 7, 2026

Uh oh!

coopbri commented Jan 7, 2026

Uh oh!

cla-bot Bot commented Jan 7, 2026

Uh oh!

zed-industries-bot commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coopbri commented Feb 8, 2026

Uh oh!

g5becks commented Feb 10, 2026

Uh oh!

rxmarbles commented Feb 18, 2026

Uh oh!

coopbri commented Feb 18, 2026

Uh oh!

coopbri commented Feb 18, 2026

Uh oh!

coopbri commented Feb 18, 2026

Uh oh!

laris commented Feb 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

coopbri commented Jan 7, 2026 •

edited

Loading

zed-industries-bot commented Jan 29, 2026 •

edited

Loading