From d19dcf89bdc8368091e54b23e641ec8a96c13659 Mon Sep 17 00:00:00 2001
From: Jiayuan <forrestchang7@gmail.com>
Date: Wed, 14 Jan 2026 03:07:28 +0800
Subject: [PATCH] docs: improve README with quick start and install
 instructions

- Add Quick Start section with pnpm install + doctor + cli flow
- Add install commands to Supported Agents table
- Reorganize sections for better flow
- Simplify Doctor section description
- Move Development section after CLI docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 README.md | 56 +++++++++++++++++++++++++++----------------------------
 1 file changed, 27 insertions(+), 29 deletions(-)

diff --git a/README.md b/README.md
index 01d011951..0b69714e8 100644
--- a/README.md
+++ b/README.md
@@ -6,26 +6,23 @@ Multica uses the [Agent Client Protocol (ACP)](https://github.com/anthropics/age
 
 ## Supported Agents
 
-| Agent | Command | Notes |
-|-------|---------|-------|
-| [OpenCode](https://github.com/anomalyco/opencode) | `opencode acp` | |
-| [Codex CLI (ACP)](https://github.com/zed-industries/codex-acp) | `codex-acp` | Community ACP wrapper |
-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini acp` | |
+| Agent | Command | Install |
+|-------|---------|---------|
+| [OpenCode](https://github.com/opencode-ai/opencode) | `opencode acp` | `go install github.com/opencode-ai/opencode@latest` |
+| [Codex CLI (ACP)](https://github.com/zed-industries/codex-acp) | `codex-acp` | `npm install -g codex-acp` |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini acp` | `npm install -g @google/gemini-cli` |
 
-## Setup
+## Quick Start
 
 ```bash
+# Install dependencies
 pnpm install
-```
 
-## Development
+# Check which agents are installed
+pnpm cli doctor
 
-```bash
-# Start Electron app in dev mode
-pnpm dev
-
-# Type check
-pnpm typecheck
+# Start interactive mode
+pnpm cli
 ```
 
 ## CLI
@@ -49,13 +46,13 @@ Start an interactive REPL session:
 pnpm cli
 ```
 
-Available commands in interactive mode:
+Available commands:
 
 | Command | Description |
 |---------|-------------|
 | `/help` | Show help |
-| `/sessions` | List all sessions |
 | `/new [cwd]` | Create new session (default: current directory) |
+| `/sessions` | List all sessions |
 | `/resume <id>` | Resume session by ID prefix |
 | `/delete <id>` | Delete a session |
 | `/history` | Show current session message history |
@@ -83,11 +80,7 @@ Check if agents are installed on your system:
 pnpm cli doctor
 ```
 
-This will show:
-- Installation status for each agent
-- Path to the installed binary
-- Version information (when available)
-- Install commands for missing agents
+Shows installation status, binary path, version, and install hints for missing agents.
 
 ### Options
 
@@ -102,17 +95,22 @@ This will show:
 - Press `Ctrl+C` once to send a cancel request to the agent
 - Press `Ctrl+C` twice to force quit
 
+## Development
+
+```bash
+# Start Electron app in dev mode
+pnpm dev
+
+# Type check
+pnpm typecheck
+```
+
 ## Build
 
 ```bash
-# macOS
-pnpm build:mac
-
-# Windows
-pnpm build:win
-
-# Linux
-pnpm build:linux
+pnpm build:mac      # macOS
+pnpm build:win      # Windows
+pnpm build:linux    # Linux
 ```
 
 ## Architecture