Files
openwork/apps/app/pr/multi-workspace-config.md
Omar McAdam 2b91b4d777 refactor: repo folder structure (#1038)
* refactor(repo): move OpenWork apps into apps and ee layout

Rebase the monorepo layout migration onto the latest dev changes so the moved app, desktop, share, and cloud surfaces keep working from their new paths. Carry the latest deeplink, token persistence, build, Vercel, and docs updates forward to avoid stale references and broken deploy tooling.

* chore(repo): drop generated desktop artifacts

Ignore the moved Tauri target and sidecar paths so local cargo checks do not pollute the branch. Remove the accidentally committed outputs from the repo while keeping the layout migration intact.

* fix(release): drop built server cli artifact

Stop tracking the locally built apps/server/cli binary so generated server outputs do not leak into commits. Also update the release workflow to check the published scoped package name for @openwork/server before deciding whether npm publish is needed.

* fix(workspace): add stable CLI bin wrappers

Point the server and router package bins at committed wrapper scripts so workspace installs can create shims before dist outputs exist. Keep the wrappers compatible with built binaries and source checkouts to avoid Vercel install warnings without changing runtime behavior.
2026-03-19 11:41:38 -07:00

3.2 KiB

title, description
title description
Workspaces Share settings across projects with minimal friction

Summarize

Enable multiple workspace profiles with quick switching and safe config sharing. The experience should feel native to the current dashboard, sessions list, and onboarding flow.


Define problem

Teams need separate workspace contexts while keeping a few trusted defaults consistent. Today, users duplicate setup steps and lose track of which config applies where.


Set goals

  • Add workspace profiles without disrupting existing single-workspace users
  • Keep switching fast and visible from the dashboard and sessions list
  • Allow config export/import with clear scope and safe defaults

Set non-goals

  • No cross-device sync in this phase
  • No multi-user permissions or ACL management
  • No changes to OpenCode runtime config precedence

Describe personas

  • Solo builder who toggles between client projects
  • Team lead who shares a baseline setup across projects
  • New user who wants a guided first-time flow

Map UX flow

Onboarding: choose a starter workspace or import a shared config, then land on the dashboard. Show a simple selector next to the existing project entry.

Switching: use the dashboard workspace picker with search and recent items, then reload the sessions list for that workspace. Show a toast confirming the active context.

Sessions list: group sessions by active workspace with a small badge and reuse the current list layout. Provide a filter toggle to show all or current only.


Define export/import

Scope: export workspace-level config, model defaults, and skill selection. Keep project-specific file paths relative when possible.

Exclusions: omit secrets, tokens, local cache, and device-specific paths. Skip any files flagged as private in config metadata.

Security: show a review screen before export, and confirm before import applies changes. Validate manifest schema and warn on unknown keys.


List requirements

Functional: create, rename, delete, and switch workspace profiles. Export and import configs as a single archive with a manifest.

UX: fit within existing dashboard cards and onboarding panels. Keep the active workspace visible on sessions list and session detail.


Specify data

Manifest: JSON with workspace name, version, createdAt, config scope, and file map. Include a checksum per file entry.

Archive: zip containing manifest.json plus normalized config files. Preserve relative paths and strip secrets on export.


Assess risks

  • Users might assume config syncs across devices
  • Imports could overwrite local preferences unexpectedly
  • Large configs may slow onboarding or switching

Raise questions

  • Should imports create a new workspace by default or merge into active
  • How should we surface config precedence conflicts in UI
  • Do we need a dry-run view for imports in v1

Measure success

  • 30% of active users create a second workspace
  • 70% of imports complete without rollback
  • Switching time stays under 1 second on median devices

Plan rollout

Phase 1: local profiles with switching and sessions filtering. Phase 2: export and import with manifest validation and review.