Separate README and docs intro

- Break symlink: README and intro.md are now separate files
- README is minimal and links to published docs
- intro.md is comprehensive documentation welcome page
- README focuses on quick start and links out

Author: ammario

README.md

@@ -3,20 +3,31 @@
 [![CI](https://github.com/coder/cmux/actions/workflows/ci.yml/badge.svg)](https://github.com/coder/cmux/actions/workflows/ci.yml)
 [![Build](https://github.com/coder/cmux/actions/workflows/build.yml/badge.svg)](https://github.com/coder/cmux/actions/workflows/build.yml)
 
-A cross-platform desktop application for managing multiple coding agents.
+A cross-platform desktop application for AI-assisted development with git worktree integration.
 
-Key features:
-- Supports both OpenAI and Anthropic models with consistent interface
-- Workspace isolation with git worktrees
-- Much richer interface than traditional TUIs
-  - E.g., ask the agent for an architecture diagram of your codebase
+## Documentation
 
-## Caveats
+📚 **[Read the full documentation →](https://coder.github.io/cmux)**
 
-- Early stage, Alpha software
-- Built artifacts for macOS and Linux only
-- Majority of testing on `claude-sonnet-4-5`
+- [Installation](https://coder.github.io/cmux/install.html)
+- [Keyboard Shortcuts](https://coder.github.io/cmux/keybinds.html)
+- [Developer Guide](https://coder.github.io/cmux/AGENTS.html)
+
+## Quick Install
+
+Download pre-built binaries from [GitHub Actions artifacts](https://github.com/coder/cmux/actions/workflows/build.yml):
+
+- **macOS**: Universal binary DMG (Intel + Apple Silicon)
+- **Linux**: AppImage
 
 ## Development
 
 See [AGENTS.md](./AGENTS.md) for development setup and guidelines.
+
+## Features
+
+- 🔀 Git worktree integration for multi-branch workflows
+- 🤖 Multiple AI permission modes (plan/edit/yolo)
+- 📦 Multi-project management
+- 💬 Persistent session history
+- ⌨️ Keyboard-first interface

docs/src/intro.md

@@ -0,0 +1,28 @@
+# Introduction
+
+**cmux** (Coding Agent Multiplexer) is a cross-platform desktop application for AI-assisted development with git worktree integration.
+
+## What is cmux?
+
+cmux helps you work with AI coding assistants more effectively by:
+
+- 🔀 **Git Worktree Integration** - Work on multiple branches simultaneously without switching contexts
+- 🤖 **Multiple Permission Modes** - Control how aggressively the AI can modify your code (plan/edit/yolo)
+- 📦 **Project Management** - Organize and switch between multiple projects seamlessly
+- 💬 **Session History** - Full chat history persistence across sessions
+- 🔄 **Flexible Workflows** - Support for different AI models and providers
+
+## Why cmux?
+
+Traditional AI coding assistants require constant context switching between branches and can be disruptive to existing workflows. cmux solves this by leveraging git worktrees, allowing you to:
+
+- Keep multiple feature branches active simultaneously
+- Isolate AI experiments from your main codebase
+- Maintain separate chat contexts for different tasks
+- Quickly switch between different AI models and configurations
+
+## Quick Links
+
+- [Install](./install.md) - Download and installation instructions
+- [Keyboard Shortcuts](./keybinds.md) - Complete keyboard reference
+- [AGENTS](./AGENTS.md) - Developer guide for AI assistants