feat(sidebar): group threads by environment

[roerohan]

Users connected to multiple computers could identify a thread's environment, but could not section the sidebar by where work runs.

Add a client-local environment grouping preference across web, desktop, and mobile. The default sidebar keeps its pinned, active, snoozed, and settled structure while adding environment headings; the project-tree sidebar nests projects under environment sections and scopes repository grouping within each environment.

Tests:

• vp test run packages/contracts/src/settings.test.ts apps/web/src/environmentGrouping.test.ts apps/web/src/components/Sidebar.logic.test.ts apps/mobile/src/features/home/homeThreadList.test.ts apps/mobile/src/features/home/homeListItems.test.ts
• vp run typecheck in apps/web, apps/mobile, and packages/contracts
• Manually tested the feature frontend against an active T3 server

Model: GPT-5.6 Sol
Harness: OpenCode

Section headers look like this:

Enable in Settings / General:

---

Note

Medium Risk
Touches sidebar ordering, grouping keys, and pinned reorder semantics across web and mobile; incorrect scoping could mis-filter threads or merge projects across environments, but changes are gated behind an opt-in default-off setting.

Overview
Adds a client-local “group by environment” preference (sidebarEnvironmentGroupingEnabled on web, environmentGroupingEnabled on mobile) so multi-machine workspaces can section the sidebar by where work runs.

On web, the default sidebar inserts environment headings inside pinned, active, snoozed, and settled areas; pinned drag-reorder is limited to threads in the same environment, with helpers to keep optimistic pinned order in sync when toggling the mode. The legacy project-tree sidebar nests projects under environment sections via buildSidebarProjectGrouping, keeps repository grouping within each environment (no cross-environment merge), disables manual project sort while grouping is on, and routes project settings using logicalProjectKey.

On mobile (legacy grouped list only, when viewing all environments), scopes and thread groups are built per environment, the list gains environment-header rows, and project filters show title · environment labels. The toggle lives under Settings → Project Grouping.

Settings surfaces the control on web General settings (search + restore-defaults) and persist it in mobile preferences. Tests and user docs cover the new behavior.

^{Reviewed by Cursor Bugbot for commit a181428. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Group sidebar threads and projects by environment

• Adds the sidebarEnvironmentGroupingEnabled client setting (default false) with toggle UI in web General settings and the mobile Project Grouping screen, plus settings-search support.
• Web Sidebar and LegacySidebar render active, pinned, snoozed, and settled threads under environment headings when enabled; pinned drag-and-drop is scoped to the active thread's environment, and manual project sort is disabled in that mode.
• Mobile HomeScreen and ThreadNavigationSidebar build environment-separated project scopes and thread groups, inserting environment-header list rows; grouping applies only when no specific environment filter is selected.
• Replaces the separate sidebar snapshot and key-map builders with buildSidebarProjectGrouping, which partitions projects by environment and adds logicalProjectKey to each snapshot.
• Behavioral Change: when grouping is enabled, matching projects from different environments become separate sidebar snapshots with environment-prefixed projectKeys and no manual sort; switching the setting clears pinned optimistic order. The selectPinnedReorderSection and shouldApplyOptimisticPinnedOrder helpers in Sidebar.logic.ts enforce the environment-mode match.

^{Macroscope summarized a181428.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 629525f. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces an opt-in environment-grouping capability across web and mobile, changing sidebar layout, project identity keys, sorting, and pinned drag-and-drop behavior across multiple production paths. Its default-off setting preserves existing startup behavior, but the breadth of the new runtime logic and cross-platform interaction changes warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Environment grouping is threaded consistently through the settings surface and both web sidebars, but the legacy sidebar's env-scoped projectKey leaks into a cross-surface route contract, which breaks the "Project settings" entry point while the toggle is on. Remaining comments are scoped to accessible naming, section ordering parity between the two sidebars, and the repeated heading treatment.

^{Posted via Macroscope — UI Consistency}

[shivamhwp]

Note: GPT-5.6 Sol on behalf of shivam (@shivamhwp).

Thanks for putting this together. The PR itself is well done, but we are going to close it in favor of #8530.

Environment grouping moves navigation toward the older project-tree style. With many threads, it adds more sections without reducing the list, so users still have to scroll through everything. #8530 addresses the same need with an environment filter in the current sidebar, letting users narrow the list to the environments they want.

We appreciate the work and thought that went into this.

[roerohan]

Users connected to multiple computers could identify a thread's environment, but could not section the sidebar by where work runs.

Add a client-local environment grouping preference across web, desktop, and mobile. The default sidebar keeps its pinned, active, snoozed, and settled structure while adding environment headings; the project-tree sidebar nests projects under environment sections and scopes repository grouping within each environment.

Tests:

• vp test run packages/contracts/src/settings.test.ts apps/web/src/environmentGrouping.test.ts apps/web/src/components/Sidebar.logic.test.ts apps/mobile/src/features/home/homeThreadList.test.ts apps/mobile/src/features/home/homeListItems.test.ts
• vp run typecheck in apps/web, apps/mobile, and packages/contracts
• Manually tested the feature frontend against an active T3 server

Model: GPT-5.6 Sol
Harness: OpenCode

Section headers look like this:

Enable in Settings / General:

---

Note

Medium Risk
Touches sidebar ordering, grouping keys, and pinned reorder semantics across web and mobile; incorrect scoping could mis-filter threads or merge projects across environments, but changes are gated behind an opt-in default-off setting.

Overview
Adds a client-local “group by environment” preference (sidebarEnvironmentGroupingEnabled on web, environmentGroupingEnabled on mobile) so multi-machine workspaces can section the sidebar by where work runs.

On web, the default sidebar inserts environment headings inside pinned, active, snoozed, and settled areas; pinned drag-reorder is limited to threads in the same environment, with helpers to keep optimistic pinned order in sync when toggling the mode. The legacy project-tree sidebar nests projects under environment sections via buildSidebarProjectGrouping, keeps repository grouping within each environment (no cross-environment merge), disables manual project sort while grouping is on, and routes project settings using logicalProjectKey.

On mobile (legacy grouped list only, when viewing all environments), scopes and thread groups are built per environment, the list gains environment-header rows, and project filters show title · environment labels. The toggle lives under Settings → Project Grouping.

Settings surfaces the control on web General settings (search + restore-defaults) and persist it in mobile preferences. Tests and user docs cover the new behavior.

^{Reviewed by Cursor Bugbot for commit a181428. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Group sidebar threads and projects by environment

• Adds the sidebarEnvironmentGroupingEnabled client setting (default false) with toggle UI in web General settings and the mobile Project Grouping screen, plus settings-search support.
• Web Sidebar and LegacySidebar render active, pinned, snoozed, and settled threads under environment headings when enabled; pinned drag-and-drop is scoped to the active thread's environment, and manual project sort is disabled in that mode.
• Mobile HomeScreen and ThreadNavigationSidebar build environment-separated project scopes and thread groups, inserting environment-header list rows; grouping applies only when no specific environment filter is selected.
• Replaces the separate sidebar snapshot and key-map builders with buildSidebarProjectGrouping, which partitions projects by environment and adds logicalProjectKey to each snapshot.
• Behavioral Change: when grouping is enabled, matching projects from different environments become separate sidebar snapshots with environment-prefixed projectKeys and no manual sort; switching the setting clears pinned optimistic order. The selectPinnedReorderSection and shouldApplyOptimisticPinnedOrder helpers in Sidebar.logic.ts enforce the environment-mode match.

^{Macroscope summarized a181428.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 629525f. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces an opt-in environment-grouping capability across web and mobile, changing sidebar layout, project identity keys, sorting, and pinned drag-and-drop behavior across multiple production paths. Its default-off setting preserves existing startup behavior, but the breadth of the new runtime logic and cross-platform interaction changes warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Environment grouping is threaded consistently through the settings surface and both web sidebars, but the legacy sidebar's env-scoped projectKey leaks into a cross-surface route contract, which breaks the "Project settings" entry point while the toggle is on. Remaining comments are scoped to accessible naming, section ordering parity between the two sidebars, and the repeated heading treatment.

^{Posted via Macroscope — UI Consistency}

[shivamhwp]

Note: GPT-5.6 Sol on behalf of shivam (@shivamhwp).

Thanks for putting this together. The PR itself is well done, but we are going to close it in favor of #8530.

Environment grouping moves navigation toward the older project-tree style. With many threads, it adds more sections without reducing the list, so users still have to scroll through everything. #8530 addresses the same need with an environment filter in the current sidebar, letting users narrow the list to the environments they want.

We appreciate the work and thought that went into this.

[roerohan]

Users connected to multiple computers could identify a thread's environment, but could not section the sidebar by where work runs.

Add a client-local environment grouping preference across web, desktop, and mobile. The default sidebar keeps its pinned, active, snoozed, and settled structure while adding environment headings; the project-tree sidebar nests projects under environment sections and scopes repository grouping within each environment.

Tests:

• vp test run packages/contracts/src/settings.test.ts apps/web/src/environmentGrouping.test.ts apps/web/src/components/Sidebar.logic.test.ts apps/mobile/src/features/home/homeThreadList.test.ts apps/mobile/src/features/home/homeListItems.test.ts
• vp run typecheck in apps/web, apps/mobile, and packages/contracts
• Manually tested the feature frontend against an active T3 server

Model: GPT-5.6 Sol
Harness: OpenCode

Section headers look like this:

Enable in Settings / General:

---

Note

Medium Risk
Touches sidebar ordering, grouping keys, and pinned reorder semantics across web and mobile; incorrect scoping could mis-filter threads or merge projects across environments, but changes are gated behind an opt-in default-off setting.

Overview
Adds a client-local “group by environment” preference (sidebarEnvironmentGroupingEnabled on web, environmentGroupingEnabled on mobile) so multi-machine workspaces can section the sidebar by where work runs.

On web, the default sidebar inserts environment headings inside pinned, active, snoozed, and settled areas; pinned drag-reorder is limited to threads in the same environment, with helpers to keep optimistic pinned order in sync when toggling the mode. The legacy project-tree sidebar nests projects under environment sections via buildSidebarProjectGrouping, keeps repository grouping within each environment (no cross-environment merge), disables manual project sort while grouping is on, and routes project settings using logicalProjectKey.

On mobile (legacy grouped list only, when viewing all environments), scopes and thread groups are built per environment, the list gains environment-header rows, and project filters show title · environment labels. The toggle lives under Settings → Project Grouping.

Settings surfaces the control on web General settings (search + restore-defaults) and persist it in mobile preferences. Tests and user docs cover the new behavior.

^{Reviewed by Cursor Bugbot for commit a181428. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Group sidebar threads and projects by environment

• Adds the sidebarEnvironmentGroupingEnabled client setting (default false) with toggle UI in web General settings and the mobile Project Grouping screen, plus settings-search support.
• Web Sidebar and LegacySidebar render active, pinned, snoozed, and settled threads under environment headings when enabled; pinned drag-and-drop is scoped to the active thread's environment, and manual project sort is disabled in that mode.
• Mobile HomeScreen and ThreadNavigationSidebar build environment-separated project scopes and thread groups, inserting environment-header list rows; grouping applies only when no specific environment filter is selected.
• Replaces the separate sidebar snapshot and key-map builders with buildSidebarProjectGrouping, which partitions projects by environment and adds logicalProjectKey to each snapshot.
• Behavioral Change: when grouping is enabled, matching projects from different environments become separate sidebar snapshots with environment-prefixed projectKeys and no manual sort; switching the setting clears pinned optimistic order. The selectPinnedReorderSection and shouldApplyOptimisticPinnedOrder helpers in Sidebar.logic.ts enforce the environment-mode match.

^{Macroscope summarized a181428.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 629525f. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces an opt-in environment-grouping capability across web and mobile, changing sidebar layout, project identity keys, sorting, and pinned drag-and-drop behavior across multiple production paths. Its default-off setting preserves existing startup behavior, but the breadth of the new runtime logic and cross-platform interaction changes warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Environment grouping is threaded consistently through the settings surface and both web sidebars, but the legacy sidebar's env-scoped projectKey leaks into a cross-surface route contract, which breaks the "Project settings" entry point while the toggle is on. Remaining comments are scoped to accessible naming, section ordering parity between the two sidebars, and the repeated heading treatment.

^{Posted via Macroscope — UI Consistency}

[shivamhwp]

Note: GPT-5.6 Sol on behalf of shivam (@shivamhwp).

Thanks for putting this together. The PR itself is well done, but we are going to close it in favor of #8530.

Environment grouping moves navigation toward the older project-tree style. With many threads, it adds more sections without reducing the list, so users still have to scroll through everything. #8530 addresses the same need with an environment filter in the current sidebar, letting users narrow the list to the environments they want.

We appreciate the work and thought that went into this.

[roerohan]

Users connected to multiple computers could identify a thread's environment, but could not section the sidebar by where work runs.

Add a client-local environment grouping preference across web, desktop, and mobile. The default sidebar keeps its pinned, active, snoozed, and settled structure while adding environment headings; the project-tree sidebar nests projects under environment sections and scopes repository grouping within each environment.

Tests:

• vp test run packages/contracts/src/settings.test.ts apps/web/src/environmentGrouping.test.ts apps/web/src/components/Sidebar.logic.test.ts apps/mobile/src/features/home/homeThreadList.test.ts apps/mobile/src/features/home/homeListItems.test.ts
• vp run typecheck in apps/web, apps/mobile, and packages/contracts
• Manually tested the feature frontend against an active T3 server

Model: GPT-5.6 Sol
Harness: OpenCode

Section headers look like this:

Enable in Settings / General:

---

Note

Medium Risk
Touches sidebar ordering, grouping keys, and pinned reorder semantics across web and mobile; incorrect scoping could mis-filter threads or merge projects across environments, but changes are gated behind an opt-in default-off setting.

Overview
Adds a client-local “group by environment” preference (sidebarEnvironmentGroupingEnabled on web, environmentGroupingEnabled on mobile) so multi-machine workspaces can section the sidebar by where work runs.

On web, the default sidebar inserts environment headings inside pinned, active, snoozed, and settled areas; pinned drag-reorder is limited to threads in the same environment, with helpers to keep optimistic pinned order in sync when toggling the mode. The legacy project-tree sidebar nests projects under environment sections via buildSidebarProjectGrouping, keeps repository grouping within each environment (no cross-environment merge), disables manual project sort while grouping is on, and routes project settings using logicalProjectKey.

On mobile (legacy grouped list only, when viewing all environments), scopes and thread groups are built per environment, the list gains environment-header rows, and project filters show title · environment labels. The toggle lives under Settings → Project Grouping.

Settings surfaces the control on web General settings (search + restore-defaults) and persist it in mobile preferences. Tests and user docs cover the new behavior.

^{Reviewed by Cursor Bugbot for commit a181428. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Group sidebar threads and projects by environment

• Adds the sidebarEnvironmentGroupingEnabled client setting (default false) with toggle UI in web General settings and the mobile Project Grouping screen, plus settings-search support.
• Web Sidebar and LegacySidebar render active, pinned, snoozed, and settled threads under environment headings when enabled; pinned drag-and-drop is scoped to the active thread's environment, and manual project sort is disabled in that mode.
• Mobile HomeScreen and ThreadNavigationSidebar build environment-separated project scopes and thread groups, inserting environment-header list rows; grouping applies only when no specific environment filter is selected.
• Replaces the separate sidebar snapshot and key-map builders with buildSidebarProjectGrouping, which partitions projects by environment and adds logicalProjectKey to each snapshot.
• Behavioral Change: when grouping is enabled, matching projects from different environments become separate sidebar snapshots with environment-prefixed projectKeys and no manual sort; switching the setting clears pinned optimistic order. The selectPinnedReorderSection and shouldApplyOptimisticPinnedOrder helpers in Sidebar.logic.ts enforce the environment-mode match.

^{Macroscope summarized a181428.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 629525f. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces an opt-in environment-grouping capability across web and mobile, changing sidebar layout, project identity keys, sorting, and pinned drag-and-drop behavior across multiple production paths. Its default-off setting preserves existing startup behavior, but the breadth of the new runtime logic and cross-platform interaction changes warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Environment grouping is threaded consistently through the settings surface and both web sidebars, but the legacy sidebar's env-scoped projectKey leaks into a cross-surface route contract, which breaks the "Project settings" entry point while the toggle is on. Remaining comments are scoped to accessible naming, section ordering parity between the two sidebars, and the repeated heading treatment.

^{Posted via Macroscope — UI Consistency}

[shivamhwp]

Note: GPT-5.6 Sol on behalf of shivam (@shivamhwp).

Thanks for putting this together. The PR itself is well done, but we are going to close it in favor of #8530.

Environment grouping moves navigation toward the older project-tree style. With many threads, it adds more sections without reducing the list, so users still have to scroll through everything. #8530 addresses the same need with an environment filter in the current sidebar, letting users narrow the list to the environments they want.

We appreciate the work and thought that went into this.

[roerohan]

Users connected to multiple computers could identify a thread's environment, but could not section the sidebar by where work runs.

Add a client-local environment grouping preference across web, desktop, and mobile. The default sidebar keeps its pinned, active, snoozed, and settled structure while adding environment headings; the project-tree sidebar nests projects under environment sections and scopes repository grouping within each environment.

Tests:

• vp test run packages/contracts/src/settings.test.ts apps/web/src/environmentGrouping.test.ts apps/web/src/components/Sidebar.logic.test.ts apps/mobile/src/features/home/homeThreadList.test.ts apps/mobile/src/features/home/homeListItems.test.ts
• vp run typecheck in apps/web, apps/mobile, and packages/contracts
• Manually tested the feature frontend against an active T3 server

Model: GPT-5.6 Sol
Harness: OpenCode

Section headers look like this:

Enable in Settings / General:

---

Note

Medium Risk
Touches sidebar ordering, grouping keys, and pinned reorder semantics across web and mobile; incorrect scoping could mis-filter threads or merge projects across environments, but changes are gated behind an opt-in default-off setting.

Overview
Adds a client-local “group by environment” preference (sidebarEnvironmentGroupingEnabled on web, environmentGroupingEnabled on mobile) so multi-machine workspaces can section the sidebar by where work runs.

On web, the default sidebar inserts environment headings inside pinned, active, snoozed, and settled areas; pinned drag-reorder is limited to threads in the same environment, with helpers to keep optimistic pinned order in sync when toggling the mode. The legacy project-tree sidebar nests projects under environment sections via buildSidebarProjectGrouping, keeps repository grouping within each environment (no cross-environment merge), disables manual project sort while grouping is on, and routes project settings using logicalProjectKey.

On mobile (legacy grouped list only, when viewing all environments), scopes and thread groups are built per environment, the list gains environment-header rows, and project filters show title · environment labels. The toggle lives under Settings → Project Grouping.

Settings surfaces the control on web General settings (search + restore-defaults) and persist it in mobile preferences. Tests and user docs cover the new behavior.

^{Reviewed by Cursor Bugbot for commit a181428. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Group sidebar threads and projects by environment

• Adds the sidebarEnvironmentGroupingEnabled client setting (default false) with toggle UI in web General settings and the mobile Project Grouping screen, plus settings-search support.
• Web Sidebar and LegacySidebar render active, pinned, snoozed, and settled threads under environment headings when enabled; pinned drag-and-drop is scoped to the active thread's environment, and manual project sort is disabled in that mode.
• Mobile HomeScreen and ThreadNavigationSidebar build environment-separated project scopes and thread groups, inserting environment-header list rows; grouping applies only when no specific environment filter is selected.
• Replaces the separate sidebar snapshot and key-map builders with buildSidebarProjectGrouping, which partitions projects by environment and adds logicalProjectKey to each snapshot.
• Behavioral Change: when grouping is enabled, matching projects from different environments become separate sidebar snapshots with environment-prefixed projectKeys and no manual sort; switching the setting clears pinned optimistic order. The selectPinnedReorderSection and shouldApplyOptimisticPinnedOrder helpers in Sidebar.logic.ts enforce the environment-mode match.

^{Macroscope summarized a181428.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 629525f. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces an opt-in environment-grouping capability across web and mobile, changing sidebar layout, project identity keys, sorting, and pinned drag-and-drop behavior across multiple production paths. Its default-off setting preserves existing startup behavior, but the breadth of the new runtime logic and cross-platform interaction changes warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Environment grouping is threaded consistently through the settings surface and both web sidebars, but the legacy sidebar's env-scoped projectKey leaks into a cross-surface route contract, which breaks the "Project settings" entry point while the toggle is on. Remaining comments are scoped to accessible naming, section ordering parity between the two sidebars, and the repeated heading treatment.

^{Posted via Macroscope — UI Consistency}

[shivamhwp]

Note: GPT-5.6 Sol on behalf of shivam (@shivamhwp).

Thanks for putting this together. The PR itself is well done, but we are going to close it in favor of #8530.

Environment grouping moves navigation toward the older project-tree style. With many threads, it adds more sections without reducing the list, so users still have to scroll through everything. #8530 addresses the same need with an environment filter in the current sidebar, letting users narrow the list to the environments they want.

We appreciate the work and thought that went into this.

[roerohan]

Users connected to multiple computers could identify a thread's environment, but could not section the sidebar by where work runs.

Add a client-local environment grouping preference across web, desktop, and mobile. The default sidebar keeps its pinned, active, snoozed, and settled structure while adding environment headings; the project-tree sidebar nests projects under environment sections and scopes repository grouping within each environment.

Tests:

• vp test run packages/contracts/src/settings.test.ts apps/web/src/environmentGrouping.test.ts apps/web/src/components/Sidebar.logic.test.ts apps/mobile/src/features/home/homeThreadList.test.ts apps/mobile/src/features/home/homeListItems.test.ts
• vp run typecheck in apps/web, apps/mobile, and packages/contracts
• Manually tested the feature frontend against an active T3 server

Model: GPT-5.6 Sol
Harness: OpenCode

Section headers look like this:

Enable in Settings / General:

---

Note

Medium Risk
Touches sidebar ordering, grouping keys, and pinned reorder semantics across web and mobile; incorrect scoping could mis-filter threads or merge projects across environments, but changes are gated behind an opt-in default-off setting.

Overview
Adds a client-local “group by environment” preference (sidebarEnvironmentGroupingEnabled on web, environmentGroupingEnabled on mobile) so multi-machine workspaces can section the sidebar by where work runs.

On web, the default sidebar inserts environment headings inside pinned, active, snoozed, and settled areas; pinned drag-reorder is limited to threads in the same environment, with helpers to keep optimistic pinned order in sync when toggling the mode. The legacy project-tree sidebar nests projects under environment sections via buildSidebarProjectGrouping, keeps repository grouping within each environment (no cross-environment merge), disables manual project sort while grouping is on, and routes project settings using logicalProjectKey.

On mobile (legacy grouped list only, when viewing all environments), scopes and thread groups are built per environment, the list gains environment-header rows, and project filters show title · environment labels. The toggle lives under Settings → Project Grouping.

Settings surfaces the control on web General settings (search + restore-defaults) and persist it in mobile preferences. Tests and user docs cover the new behavior.

^{Reviewed by Cursor Bugbot for commit a181428. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Group sidebar threads and projects by environment

• Adds the sidebarEnvironmentGroupingEnabled client setting (default false) with toggle UI in web General settings and the mobile Project Grouping screen, plus settings-search support.
• Web Sidebar and LegacySidebar render active, pinned, snoozed, and settled threads under environment headings when enabled; pinned drag-and-drop is scoped to the active thread's environment, and manual project sort is disabled in that mode.
• Mobile HomeScreen and ThreadNavigationSidebar build environment-separated project scopes and thread groups, inserting environment-header list rows; grouping applies only when no specific environment filter is selected.
• Replaces the separate sidebar snapshot and key-map builders with buildSidebarProjectGrouping, which partitions projects by environment and adds logicalProjectKey to each snapshot.
• Behavioral Change: when grouping is enabled, matching projects from different environments become separate sidebar snapshots with environment-prefixed projectKeys and no manual sort; switching the setting clears pinned optimistic order. The selectPinnedReorderSection and shouldApplyOptimisticPinnedOrder helpers in Sidebar.logic.ts enforce the environment-mode match.

^{Macroscope summarized a181428.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 629525f. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces an opt-in environment-grouping capability across web and mobile, changing sidebar layout, project identity keys, sorting, and pinned drag-and-drop behavior across multiple production paths. Its default-off setting preserves existing startup behavior, but the breadth of the new runtime logic and cross-platform interaction changes warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Environment grouping is threaded consistently through the settings surface and both web sidebars, but the legacy sidebar's env-scoped projectKey leaks into a cross-surface route contract, which breaks the "Project settings" entry point while the toggle is on. Remaining comments are scoped to accessible naming, section ordering parity between the two sidebars, and the repeated heading treatment.

^{Posted via Macroscope — UI Consistency}

[shivamhwp]

Note: GPT-5.6 Sol on behalf of shivam (@shivamhwp).

Thanks for putting this together. The PR itself is well done, but we are going to close it in favor of #8530.

Environment grouping moves navigation toward the older project-tree style. With many threads, it adds more sections without reducing the list, so users still have to scroll through everything. #8530 addresses the same need with an environment filter in the current sidebar, letting users narrow the list to the environments they want.

We appreciate the work and thought that went into this.

[roerohan]

Users connected to multiple computers could identify a thread's environment, but could not section the sidebar by where work runs.

Add a client-local environment grouping preference across web, desktop, and mobile. The default sidebar keeps its pinned, active, snoozed, and settled structure while adding environment headings; the project-tree sidebar nests projects under environment sections and scopes repository grouping within each environment.

Tests:

• vp test run packages/contracts/src/settings.test.ts apps/web/src/environmentGrouping.test.ts apps/web/src/components/Sidebar.logic.test.ts apps/mobile/src/features/home/homeThreadList.test.ts apps/mobile/src/features/home/homeListItems.test.ts
• vp run typecheck in apps/web, apps/mobile, and packages/contracts
• Manually tested the feature frontend against an active T3 server

Model: GPT-5.6 Sol
Harness: OpenCode

Section headers look like this:

Enable in Settings / General:

---

Note

Medium Risk
Touches sidebar ordering, grouping keys, and pinned reorder semantics across web and mobile; incorrect scoping could mis-filter threads or merge projects across environments, but changes are gated behind an opt-in default-off setting.

Overview
Adds a client-local “group by environment” preference (sidebarEnvironmentGroupingEnabled on web, environmentGroupingEnabled on mobile) so multi-machine workspaces can section the sidebar by where work runs.

On web, the default sidebar inserts environment headings inside pinned, active, snoozed, and settled areas; pinned drag-reorder is limited to threads in the same environment, with helpers to keep optimistic pinned order in sync when toggling the mode. The legacy project-tree sidebar nests projects under environment sections via buildSidebarProjectGrouping, keeps repository grouping within each environment (no cross-environment merge), disables manual project sort while grouping is on, and routes project settings using logicalProjectKey.

On mobile (legacy grouped list only, when viewing all environments), scopes and thread groups are built per environment, the list gains environment-header rows, and project filters show title · environment labels. The toggle lives under Settings → Project Grouping.

Settings surfaces the control on web General settings (search + restore-defaults) and persist it in mobile preferences. Tests and user docs cover the new behavior.

^{Reviewed by Cursor Bugbot for commit a181428. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Group sidebar threads and projects by environment

• Adds the sidebarEnvironmentGroupingEnabled client setting (default false) with toggle UI in web General settings and the mobile Project Grouping screen, plus settings-search support.
• Web Sidebar and LegacySidebar render active, pinned, snoozed, and settled threads under environment headings when enabled; pinned drag-and-drop is scoped to the active thread's environment, and manual project sort is disabled in that mode.
• Mobile HomeScreen and ThreadNavigationSidebar build environment-separated project scopes and thread groups, inserting environment-header list rows; grouping applies only when no specific environment filter is selected.
• Replaces the separate sidebar snapshot and key-map builders with buildSidebarProjectGrouping, which partitions projects by environment and adds logicalProjectKey to each snapshot.
• Behavioral Change: when grouping is enabled, matching projects from different environments become separate sidebar snapshots with environment-prefixed projectKeys and no manual sort; switching the setting clears pinned optimistic order. The selectPinnedReorderSection and shouldApplyOptimisticPinnedOrder helpers in Sidebar.logic.ts enforce the environment-mode match.

^{Macroscope summarized a181428.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 629525f. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces an opt-in environment-grouping capability across web and mobile, changing sidebar layout, project identity keys, sorting, and pinned drag-and-drop behavior across multiple production paths. Its default-off setting preserves existing startup behavior, but the breadth of the new runtime logic and cross-platform interaction changes warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Environment grouping is threaded consistently through the settings surface and both web sidebars, but the legacy sidebar's env-scoped projectKey leaks into a cross-surface route contract, which breaks the "Project settings" entry point while the toggle is on. Remaining comments are scoped to accessible naming, section ordering parity between the two sidebars, and the repeated heading treatment.

^{Posted via Macroscope — UI Consistency}

[shivamhwp]

Note: GPT-5.6 Sol on behalf of shivam (@shivamhwp).

Thanks for putting this together. The PR itself is well done, but we are going to close it in favor of #8530.

Environment grouping moves navigation toward the older project-tree style. With many threads, it adds more sections without reducing the list, so users still have to scroll through everything. #8530 addresses the same need with an environment filter in the current sidebar, letting users narrow the list to the environments they want.

We appreciate the work and thought that went into this.

[roerohan]

Users connected to multiple computers could identify a thread's environment, but could not section the sidebar by where work runs.

Add a client-local environment grouping preference across web, desktop, and mobile. The default sidebar keeps its pinned, active, snoozed, and settled structure while adding environment headings; the project-tree sidebar nests projects under environment sections and scopes repository grouping within each environment.

Tests:

• vp test run packages/contracts/src/settings.test.ts apps/web/src/environmentGrouping.test.ts apps/web/src/components/Sidebar.logic.test.ts apps/mobile/src/features/home/homeThreadList.test.ts apps/mobile/src/features/home/homeListItems.test.ts
• vp run typecheck in apps/web, apps/mobile, and packages/contracts
• Manually tested the feature frontend against an active T3 server

Model: GPT-5.6 Sol
Harness: OpenCode

Section headers look like this:

Enable in Settings / General:

---

Note

Medium Risk
Touches sidebar ordering, grouping keys, and pinned reorder semantics across web and mobile; incorrect scoping could mis-filter threads or merge projects across environments, but changes are gated behind an opt-in default-off setting.

Overview
Adds a client-local “group by environment” preference (sidebarEnvironmentGroupingEnabled on web, environmentGroupingEnabled on mobile) so multi-machine workspaces can section the sidebar by where work runs.

On web, the default sidebar inserts environment headings inside pinned, active, snoozed, and settled areas; pinned drag-reorder is limited to threads in the same environment, with helpers to keep optimistic pinned order in sync when toggling the mode. The legacy project-tree sidebar nests projects under environment sections via buildSidebarProjectGrouping, keeps repository grouping within each environment (no cross-environment merge), disables manual project sort while grouping is on, and routes project settings using logicalProjectKey.

On mobile (legacy grouped list only, when viewing all environments), scopes and thread groups are built per environment, the list gains environment-header rows, and project filters show title · environment labels. The toggle lives under Settings → Project Grouping.

Settings surfaces the control on web General settings (search + restore-defaults) and persist it in mobile preferences. Tests and user docs cover the new behavior.

^{Reviewed by Cursor Bugbot for commit a181428. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Group sidebar threads and projects by environment

• Adds the sidebarEnvironmentGroupingEnabled client setting (default false) with toggle UI in web General settings and the mobile Project Grouping screen, plus settings-search support.
• Web Sidebar and LegacySidebar render active, pinned, snoozed, and settled threads under environment headings when enabled; pinned drag-and-drop is scoped to the active thread's environment, and manual project sort is disabled in that mode.
• Mobile HomeScreen and ThreadNavigationSidebar build environment-separated project scopes and thread groups, inserting environment-header list rows; grouping applies only when no specific environment filter is selected.
• Replaces the separate sidebar snapshot and key-map builders with buildSidebarProjectGrouping, which partitions projects by environment and adds logicalProjectKey to each snapshot.
• Behavioral Change: when grouping is enabled, matching projects from different environments become separate sidebar snapshots with environment-prefixed projectKeys and no manual sort; switching the setting clears pinned optimistic order. The selectPinnedReorderSection and shouldApplyOptimisticPinnedOrder helpers in Sidebar.logic.ts enforce the environment-mode match.

^{Macroscope summarized a181428.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 629525f. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces an opt-in environment-grouping capability across web and mobile, changing sidebar layout, project identity keys, sorting, and pinned drag-and-drop behavior across multiple production paths. Its default-off setting preserves existing startup behavior, but the breadth of the new runtime logic and cross-platform interaction changes warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Environment grouping is threaded consistently through the settings surface and both web sidebars, but the legacy sidebar's env-scoped projectKey leaks into a cross-surface route contract, which breaks the "Project settings" entry point while the toggle is on. Remaining comments are scoped to accessible naming, section ordering parity between the two sidebars, and the repeated heading treatment.

^{Posted via Macroscope — UI Consistency}

[shivamhwp]

Note: GPT-5.6 Sol on behalf of shivam (@shivamhwp).

Thanks for putting this together. The PR itself is well done, but we are going to close it in favor of #8530.

Environment grouping moves navigation toward the older project-tree style. With many threads, it adds more sections without reducing the list, so users still have to scroll through everything. #8530 addresses the same need with an environment filter in the current sidebar, letting users narrow the list to the environments they want.

We appreciate the work and thought that went into this.