docs: fill startup options and add OS-specific install sections

Author: zebbern

README.md

@@ -41,7 +41,7 @@ docker compose up -d
 
 Need a Discord bot token first? See [Discord Bot Setup](docs/setup-discord.md).
 
-For other install methods (setup script, manual), see [Installation Guide](docs/installation.md).
+Installment options (`auto setup script` or `manual installment`), see [Installation Guide](docs/installation.md).
 
 ## Documentation
 
@@ -55,7 +55,7 @@ For other install methods (setup script, manual), see [Installation Guide](docs/
 | [Docker](docs/docker.md) | Docker Compose, GHCR images, Watchtower auto-updates |
 | [Updating](docs/updating.md) | How to update (Docker pull, git pull, version check) |
 
-## Quick Model Switching
+## Select Newest Model Available
 
 ```
 /claude-settings action:set-model value:opus
@@ -77,4 +77,25 @@ CATEGORY_NAME=claude-code
 WORK_DIR=/path/to/project
 ```
 
-<img width="250" height="250" alt="image" src="https://github.com/user-attachments/assets/2fea008b-76b7-48d8-9a87-8214cc7a24ad" />
+## Startup Options
+
+```bash
+# Standard start
+deno task start
+
+# Development mode (hot reload)
+deno task dev
+
+# Direct with environment variables
+deno run --allow-all index.ts
+
+# With optional flags
+deno run --allow-all index.ts --category myproject --user-id YOUR_DISCORD_ID
+```
+
+| Flag | Env Variable | Description |
+| --- | --- | --- |
+| `--category <name>` | `CATEGORY_NAME` | Discord category name for channels (default: `claude-code`) |
+| `--user-id <id>` | `USER_ID` | Your Discord user ID for mentions when tasks finish |
+
+> CLI flags override environment variables. Environment variables override `.env` file values.

docs/installation.md

@@ -2,6 +2,8 @@
 
 ## Option 1: Docker (Recommended)
 
+Works on all platforms with Docker installed.
+
 ```bash
 git clone https://github.com/zebbern/claude-code-discord.git
 cd claude-code-discord
@@ -10,69 +12,104 @@ cp .env.example .env
 docker compose up -d
 ```
 
-See [Docker Guide](docker.md) for full Docker usage, commands, and GHCR image details.
+See [Docker Guide](docker.md) for full Docker usage, GHCR images, and auto-updates.
+
+---
+
+## Option 2: Setup Script
 
-## Option 2: One-Command Setup
+### Linux / macOS
 
-**Linux/macOS:**
 ```bash
 git clone https://github.com/zebbern/claude-code-discord.git
 cd claude-code-discord
 chmod +x setup.sh && ./setup.sh
 ```
 
-**Windows PowerShell:**
+### Windows (PowerShell)
+
 ```powershell
 git clone https://github.com/zebbern/claude-code-discord.git
 cd claude-code-discord
 .\setup.ps1
 ```
 
-The setup script will:
-1. Install Deno (if needed)
-2. Install Claude CLI (if needed)
-3. Create `.env` file with your tokens
-4. Initialize git repository (if needed)
-5. Offer to start the bot immediately
+The setup script handles:
+
+1. Installing Deno (if not found)
+2. Installing Claude CLI (if not found)
+3. Creating `.env` with your tokens
+4. Initializing git repo (if needed)
+5. Offering to start the bot
+
+---
 
 ## Option 3: Manual Setup
 
-**Install Deno** via [deno.com](https://deno.com/) or:
+### Install Deno
+
+**Linux / macOS:**
+
 ```bash
-# Linux/macOS
 curl -fsSL https://deno.land/install.sh | sh
+```
 
-# Windows PowerShell
+**Windows (PowerShell):**
+
+```powershell
 irm https://deno.land/install.ps1 | iex
 ```
 
-**Clone and configure:**
+Or download from [deno.com](https://deno.com/).
+
+### Install Claude CLI
+
+Requires Node.js / npm:
+
+```bash
+npm install -g @anthropic-ai/claude-code
+claude /login
+```
+
+### Clone and Configure
+
 ```bash
 git clone https://github.com/zebbern/claude-code-discord.git
 cd claude-code-discord
 cp .env.example .env
-# Edit .env with your DISCORD_TOKEN and APPLICATION_ID
 ```
 
-**Install Claude CLI and login:**
+Edit `.env` with your `DISCORD_TOKEN` and `APPLICATION_ID`. See [Configuration](#configuration-env) below.
+
+### Start the Bot
+
+**Linux / macOS:**
+
 ```bash
-npm install -g @anthropic-ai/claude-code
-claude /login
+deno task start
 ```
 
-**Run the bot:**
+**Windows (PowerShell):**
+
+```powershell
+deno task start
+```
+
+**Development mode (hot reload):**
+
 ```bash
-deno task start           # Using .env file (recommended)
-deno task dev             # Development mode (hot reload)
-deno run --allow-all index.ts  # Direct execution
+deno task dev
 ```
 
-**Optional flags:**
+**With optional flags:**
+
 ```bash
 deno run --allow-all index.ts --category myproject --user-id YOUR_DISCORD_ID
 ```
 
-> If you get `not a git directory`, run `git init` first.
+> If you get `not a git directory`, run `git init` in the project folder first.
+
+---
 
 ## Configuration (.env)
 
@@ -88,4 +125,26 @@ CATEGORY_NAME=claude-code                      # Discord category for channels
 WORK_DIR=/path/to/project                      # Working directory (default: current)
 ```
 
-Environment variables take precedence over `.env` file settings.
+Environment variables override `.env` file settings. CLI flags override environment variables.
+
+---
+
+## Platform Notes
+
+### Linux / macOS
+
+- Deno and Claude CLI install via shell one-liners
+- Use `chmod +x setup.sh` before running the setup script
+- `cp` works natively for `.env.example`
+
+### Windows
+
+- Run PowerShell as Administrator if Deno install requires it
+- Use `copy .env.example .env` instead of `cp` if not using Git Bash
+- The setup script (`setup.ps1`) handles Windows-specific paths automatically
+
+### Docker (all platforms)
+
+- Docker Desktop required on Windows/macOS, Docker Engine on Linux
+- The image bundles Deno, Node.js, and Claude CLI so no local installs needed
+- See [Docker Guide](docker.md) for volumes, GHCR, and Watchtower