feat: adds floating terminal layout

[adamt94]

Summary

Adds an option to have the terminal in a floating window

• add a client setting for docked vs floating terminal layout
• render the existing terminal drawer in a floating window when selected

Settings page

floating terminal

---

Note

Low Risk
Primarily UI/presentation changes gated by a new client setting; risk is limited to potential regressions in terminal open/close behavior and layout styling.

Overview
Adds a new client setting terminalLayout (docked | floating, default docked) and exposes it in Settings so users can choose how the terminal is presented.

When set to floating, the existing terminal drawer is rendered inside a modal-style overlay with backdrop and close controls (including outside-click to dismiss), and ThreadTerminalDrawer adjusts styling based on layout. Updates header tooltips/aria labels accordingly, and extends persistence/local API tests to include the new setting.

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

Note

[!NOTE]

Add floating terminal layout option to chat view

• Adds a terminalLayout setting ("docked" | "floating") to ClientSettingsSchema in settings.ts, defaulting to "docked".
• When set to "floating", the terminal renders as a modal-like overlay with a backdrop and close button instead of the existing docked drawer.
• Adds a "Terminal layout" select control in SettingsPanels.tsx so users can switch between docked and floating modes and reset to default.
• Updates ChatHeader tooltip and aria-label to reflect whether the terminal appears as a window or drawer.

^{Macroscope summarized f5b32fe.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 46228c0b-7aff-4eb6-864b-c3304e6137c2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[macroscopeapp]

Approvability

Verdict: Needs human review

Introduces a new user-facing feature allowing terminals to display in a floating modal layout. While implementation is clean and self-contained, new UI presentation modes warrant human review to validate UX decisions and ensure accessibility.

^{You can customize Macroscope's approvability policy. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes 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 2343d3d. Configure here.}