docs: update README, CONTRIBUTING, and CLAUDE.md

Rewrite README to reflect current features (Tasks, Chat,
multi-deployment, dev containers, keyring, OAuth, SSH tuning).
Update CONTRIBUTING sidebar description. Add testing guidelines
to CLAUDE.md. Deduplicate vite in lockfile.

Author: EhabY

CLAUDE.md

@@ -25,6 +25,10 @@ Comments explain what code does or why it exists:
 ## Testing and Debugging
 
 - Tests must comprehensively cover functionality
+- Test observable behavior and outputs, not implementation details - assert on
+  return values rather than spying on internal calls
+- Keep tests idiomatic and concise - descriptive names, minimal setup, no
+  shared mutable state between tests
 - Never mock behavior in end-to-end tests - use real data
 - Mock as little as possible in unit tests - try to use real data
 - Find root causes, not symptoms. Read error messages carefully before attempting fixes.

CONTRIBUTING.md

@@ -60,11 +60,17 @@ file to display network information.
 
 ## Other features
 
-There is a sidebar that shows all the user's workspaces, and all users'
-workspaces if the user has the required permissions.
+The extension provides several sidebar panels:
 
-There are also notifications for an outdated workspace and for workspaces that
-are close to shutting down.
+- **My Workspaces / All Workspaces** - tree views showing workspaces with status
+  indicators, quick actions, and search.
+- **Coder Tasks** - a React webview for creating, monitoring, and managing AI
+  agent tasks with real-time log streaming.
+- **Coder Chat** - an embedded chat UI for delegating tasks to AI coding agents
+  (gated behind the `coder.agentsEnabled` context flag).
+
+There are also notifications for outdated workspace templates and for workspaces
+that are close to shutting down.
 
 ## Webviews
 

README.md

@@ -5,22 +5,39 @@
 [!["Join us on
 Discord"](https://badgen.net/discord/online-members/coder)](https://coder.com/chat?utm_source=github.com/coder/vscode-coder&utm_medium=github&utm_campaign=readme.md)
 
-The Coder Remote extension lets you open [Coder](https://github.com/coder/coder)
-workspaces with a single click.
+The Coder Remote extension connects your editor to
+[Coder](https://github.com/coder/coder) workspaces with a single click.
 
-- Open workspaces from the dashboard in a single click.
-- Automatically start workspaces when opened.
-- No command-line or local dependencies required - just install your editor!
-- Works in air-gapped or restricted networks. Just connect to your Coder
-  deployment!
-- Supports multiple editors: VS Code, Cursor, and Windsurf.
+![Demo](https://github.com/coder/vscode-coder/raw/main/demo.gif?raw=true)
 
-> [!NOTE]
-> The extension builds on VS Code-provided implementations of SSH. Make
-> sure you have the correct SSH extension installed for your editor
-> (`ms-vscode-remote.remote-ssh` or `codeium.windsurf-remote-openssh` for Windsurf).
+## Features
+
+- **One-click workspace access** - open workspaces from the Coder dashboard or
+  the editor sidebar. Workspaces start automatically when opened.
+- **Multi-editor support** - works with VS Code, Cursor, Windsurf, and other
+  VS Code forks.
+- **Workspace sidebar** - browse, search, and create workspaces. View agent
+  metadata and app statuses at a glance.
+- **Coder Tasks** - create, monitor, and manage AI agent tasks directly from
+  the sidebar with real-time log streaming.
+- **Coder Chat** - delegate development tasks to AI coding agents from the
+  sidebar. Requires [Coder Agents](https://coder.com/docs/ai-coder/agents) to
+  be enabled on your deployment.
+- **Multi-deployment support** - connect to multiple Coder deployments and
+  switch between them without losing credentials.
+- **Dev container support** - open dev containers running inside workspaces.
+- **Secure authentication** - session tokens stored in the OS keyring
+  (macOS/Windows), with optional OAuth 2.1 support.
+- **Air-gapped / restricted networks** - no external dependencies beyond your
+  Coder deployment.
+- **Automatic SSH tuning** - applies recommended SSH settings for reliable
+  long-lived connections and recovers from sleep/wake.
 
-![Demo](https://github.com/coder/vscode-coder/raw/main/demo.gif?raw=true)
+> [!NOTE]
+> The extension builds on VS Code-provided implementations of SSH. Make sure you
+> have the correct SSH extension installed for your editor
+> (`ms-vscode-remote.remote-ssh`, `anysphere.remote-ssh` for Cursor, or
+> `codeium.windsurf-remote-openssh` for Windsurf).
 
 ## Getting Started
 
@@ -34,11 +51,6 @@ ext install coder.coder-remote
 Alternatively, manually install the VSIX from the
 [latest release](https://github.com/coder/vscode-coder/releases/latest).
 
-### Variables Reference
-
-Coder uses `${userHome}` from VS Code's
+All extension settings are under the `coder.*` namespace in the Settings UI.
+Paths in settings accept `~` and `${userHome}` from VS Code's
 [variables reference](https://code.visualstudio.com/docs/editor/variables-reference).
-Use this when formatting paths in the Coder extension settings rather than `~`
-or `$HOME`.
-
-Example: ${userHome}/foo/bar.baz

package.json

@@ -562,7 +562,7 @@
 		"@typescript-eslint/eslint-plugin": "^8.57.2",
 		"@typescript-eslint/parser": "^8.57.2",
 		"@vitejs/plugin-react": "catalog:",
-		"@vitest/coverage-v8": "^4.1.1",
+		"@vitest/coverage-v8": "^4.1.2",
 		"@vscode/test-cli": "^0.0.12",
 		"@vscode/test-electron": "^2.5.2",
 		"@vscode/vsce": "^3.7.1",
@@ -589,7 +589,7 @@
 		"typescript-eslint": "^8.57.2",
 		"utf-8-validate": "^6.0.6",
 		"vite": "catalog:",
-		"vitest": "^4.1.1"
+		"vitest": "^4.1.2"
 	},
 	"extensionPack": [
 		"ms-vscode-remote.remote-ssh"