docs: add comprehensive documentation pages

apps/desktop/src/renderer/screens/main/components/WorkspaceSidebar/PortsList/PortsList.tsx

@@ -6,7 +6,7 @@ import { STROKE_WIDTH } from "../constants";
 import { WorkspacePortGroup } from "./components/WorkspacePortGroup";
 import { usePortsData } from "./hooks/usePortsData";
 
-const PORTS_DOCS_URL = `https://${COMPANY.DOMAIN}/ports`;
+const PORTS_DOCS_URL = `${COMPANY.DOCS_URL}/ports`;
 
 export function PortsList() {
 	const isCollapsed = usePortsStore((s) => s.isListCollapsed);

apps/docs/content/docs/agent-integration.mdx

@@ -0,0 +1,32 @@
+---
+title: AI Agents
+description: Use Claude Code and other AI agents
+---
+
+## Overview
+
+Run AI coding agents in isolated workspaces. Each agent works independently without interfering with others.
+
+![Agent](/images/agents.png)
+
+## Supported Agents
+
+- **Claude Code** - Anthropic's CLI
+- **Codex** - OpenAI's assistant
+- **OpenCode** - Open-source alternative
+
+## Usage
+
+Run agents directly in the terminal:
+
+```bash
+claude "Add error handling to fetchUser"
+```
+
+## Parallel Agents
+
+Create multiple workspaces and run an agent in each. Compare results and merge the best solution.
+
+## Notifications
+
+Get notified when agents finish. Configure sounds in Settings.

apps/docs/content/docs/customization.mdx

@@ -0,0 +1,32 @@
+---
+title: Customization
+description: Personalize Superset to your workflow
+---
+
+## Notification Sounds
+
+Get audio notifications when agents finish or terminals exit.
+
+Settings → Notifications → Choose a sound
+
+## Project Colors
+
+Color-code your projects in the sidebar for quick identification.
+
+Click project settings → Choose a color
+
+## Default Editor
+
+Set which editor opens when you press ⌘O.
+
+Settings → Editor → Select Cursor, VS Code, or other
+
+## Terminal Presets
+
+Save terminal configurations (commands, environment) as presets for quick access.
+
+Settings → Terminal → Manage Presets
+
+## Settings Sync
+
+Your settings sync across devices when signed in.

apps/docs/content/docs/diff-viewer.mdx

@@ -0,0 +1,23 @@
+---
+title: Diff Viewer
+description: Review code changes and manage your git workflow
+---
+
+## Overview
+
+Review changes, stage files, commit, and push—all from one interface.
+
+![Diff Viewer](/images/changes.png)
+
+## Features
+
+- **View changes** - See modified, staged, and untracked files
+- **Stage/unstage** - Select files for commit
+- **Commit** - Write message and commit
+- **Push/Pull** - Sync with remote
+- **Create PR** - Open pull request on GitHub
+
+## Diff Layouts
+
+- **Split view** - Side by side comparison
+- **Unified view** - Inline changes

apps/docs/content/docs/faq.mdx

@@ -0,0 +1,43 @@
+---
+title: FAQ
+description: Frequently asked questions
+---
+
+## General
+
+**What platforms?**
+macOS only. Windows/Linux coming soon.
+
+**How does it work?**
+Uses git worktrees to give each branch its own directory.
+
+**Do I need an account?**
+Yes, for team features and settings sync.
+
+## Workspaces
+
+**Same branch in multiple workspaces?**
+No. One branch = one workspace. Create a new branch if needed.
+
+**Where are workspaces stored?**
+In your Superset data directory as git worktrees.
+
+## Terminal
+
+**Which shell?**
+Your system default (bash/zsh) with your config files.
+
+**Do sessions persist?**
+Yes, terminals survive app restarts.
+
+## Git
+
+**Does it modify git config?**
+No. Uses standard git commands.
+
+**Private repos?**
+Yes. Configure GitHub auth: `gh auth status`
+
+## Getting Help
+
+- Report issues: [github.com/superset-sh/superset/issues](https://github.com/superset-sh/superset/issues)

apps/docs/content/docs/first-workspace.mdx

@@ -0,0 +1,33 @@
+---
+title: Your First Workspace
+description: Create and set up your first workspace in Superset
+---
+
+## Add a Repository
+
+Add your repo from a local folder or Git URL. Requires GitHub auth (`gh auth status`).
+
+![Add Repository](/images/add-repo.png)
+
+## Create a Workspace
+
+Each workspace is an isolated git worktree on its own branch. Superset only copies git-tracked files—use [setup scripts](/setup-teardown-scripts) for `.env` files or `bun install`.
+
+Create workspaces from:
+- New branch from main
+- Existing branch
+- Pull request
+
+![New Workspace](/images/new-workspace.png)
+
+## Start Working
+
+- **⌘O** - Open in Cursor/VS Code
+- **Terminal** - Built-in terminal ready to use
+- **Changes** - View diffs and commit
+
+## Next Steps
+
+- [Setup Scripts](/setup-teardown-scripts) - Automate `bun install`, env files
+- [Workspaces](/workspaces) - Run multiple branches at once
+- [IDE Integration](/use-with-ide) - Configure your editor

apps/docs/content/docs/installation.mdx

@@ -3,21 +3,23 @@ title: Installation
 description: Install Superset on your machine
 ---
 
-## Download for macOS
-
-Get started by downloading Superset for Apple Silicon:
+## Download
 
 <DownloadButton />
 
-## Other Platforms
+## Requirements
 
-### Windows & Linux
+- **macOS** - Apple Silicon or Intel
+- **Git** - Installed and configured
+- **GitHub CLI** - Authenticated (`gh auth status`)
 
-Windows and Linux support is coming soon. Join our waitlist to be notified when it's available.
+## Install
 
-### Build from Source
+1. Download from button above
+2. Move to Applications folder
+3. Open and sign in
 
-You can also build Superset from source on any platform:
+## Build from Source
 
 ```bash
 git clone https://github.com/superset-sh/superset.git
@@ -26,4 +28,4 @@ bun install
 bun run build
 ```
 
-See our [GitHub repository](https://github.com/superset-sh/superset) for more details.
+Windows and Linux coming soon.

apps/docs/content/docs/keyboard-shortcuts.mdx

@@ -0,0 +1,63 @@
+---
+title: Keyboard Shortcuts
+description: Customize hotkeys for common actions
+---
+
+## Workspace
+
+| Action | Shortcut |
+|--------|----------|
+| New Workspace | ⌘N |
+| Quick Create Workspace | ⌘⇧N |
+| Open Project | ⌘⇧O |
+| Switch to Workspace 1-9 | ⌘1-9 |
+| Previous Workspace | ⌘⌥↑ |
+| Next Workspace | ⌘⌥↓ |
+
+## Layout
+
+| Action | Shortcut |
+|--------|----------|
+| Toggle Changes Tab | ⌘L |
+| Toggle Expand Sidebar | ⌘⇧L |
+| Toggle Workspaces Sidebar | ⌘B |
+| Split Right | ⌘D |
+| Split Down | ⌘⇧D |
+| Split Pane Auto | ⌘E |
+| Close Pane | ⌘W |
+
+## Terminal
+
+| Action | Shortcut |
+|--------|----------|
+| New Tab | ⌘T |
+| Close Terminal | ⌘W |
+| Clear Terminal | ⌘K |
+| Find in Terminal | ⌘F |
+| Scroll to Bottom | ⌘⇧↓ |
+| Previous Tab | ⌘⌥← |
+| Next Tab | ⌘⌥→ |
+| Previous Pane | ⌘⇧← |
+| Next Pane | ⌘⇧→ |
+| Open Preset 1-9 | ⌘⇧1-9 |
+
+## Window
+
+| Action | Shortcut |
+|--------|----------|
+| Open in App | ⌘O |
+| Copy Path | ⌘⇧C |
+| Close Window | ⌘⇧W |
+| Show Keyboard Shortcuts | ⌘/ |
+
+## Customize
+
+Open Settings → Keyboard Shortcuts to customize any hotkey.
+
+![Keyboard Shortcuts Settings](/images/keyboard.png)
+
+## Import/Export
+
+Share your hotkey configuration:
+- **Export** - Save your shortcuts to a file
+- **Import** - Load shortcuts from a file

apps/docs/content/docs/meta.json

@@ -5,9 +5,20 @@
 		"quick-start",
 		"overview",
 		"installation",
+		"first-workspace",
 		"---Gauge Core Features---",
-		"core-features",
-		"---BookOpen How to Guides---",
-		"setup-teardown-scripts"
+		"workspaces",
+		"diff-viewer",
+		"terminal-integration",
+		"ports",
+		"agent-integration",
+		"---BookOpen Guides---",
+		"setup-teardown-scripts",
+		"use-with-ide",
+		"using-monorepos",
+		"keyboard-shortcuts",
+		"customization",
+		"---CircleHelp Help---",
+		"faq"
 	]
 }

apps/docs/content/docs/overview.mdx

@@ -5,55 +5,20 @@ description: Learn what Superset is and how it works
 
 ## What is Superset?
 
-Superset is a desktop application that helps developers work more efficiently with their codebase. It combines workspace management, terminal integration, and team collaboration into a single unified experience.
+Superset is a desktop app for managing multiple codebases with git worktrees. Work on several branches simultaneously, each in its own isolated workspace.
 
-## Key Features
-
-### Workspace Management
-
-Organize your projects using git worktrees. Superset makes it easy to:
-
-- Create and manage multiple worktrees for the same repository
-- Switch between branches without stashing changes
-- Keep your work organized across features and fixes
-
-### Terminal Integration
-
-Built-in terminal with powerful session management:
-
-- Multiple terminal sessions per workspace
-- Persistent sessions that survive restarts
-- Quick access to common commands
-
-### Team Collaboration
+![Superset Overview](/images/video-thumbnail.png)
 
-Work together with your team seamlessly:
+## Key Features
 
-- Share workspaces with team members
-- Sync configurations across devices
-- Manage team permissions and access
+- **Workspaces** - Each branch gets its own directory via git worktrees. No more stashing.
+- **Terminal** - Built-in terminal with persistent sessions per workspace.
+- **Diff Viewer** - Review changes, stage files, commit, and push.
+- **AI Agents** - Run Claude Code or other agents in isolated workspaces.
+- **IDE Integration** - Open any workspace in Cursor or VS Code.
 
 ## How It Works
 
-Superset sits on top of your existing git workflow and enhances it with a visual interface and productivity tools. It doesn't replace git—it makes it easier to use.
-
-### Git Worktrees
-
-Instead of switching branches in a single directory, Superset uses git worktrees to give each branch its own directory. This means:
-
-- No more stashing uncommitted changes
-- Run multiple branches simultaneously
-- Keep your IDE state intact when switching contexts
-
-### Local-First Architecture
-
-Your data stays on your machine. Superset works offline and syncs when you're connected.
-
-## Tech Stack
-
-Superset is built with modern technologies:
+Superset uses [git worktrees](https://git-scm.com/docs/git-worktree) to give each branch its own directory. Switch contexts instantly without losing your place.
 
-- **Electron** - Cross-platform desktop framework
-- **React** - UI components with TypeScript
-- **SQLite** - Local database for fast queries
-- **Git** - Version control integration
+Your data stays local. Superset works offline and syncs when connected.