swixter 0.1.0 → 0.1.2

package/README.md

@@ -2,9 +2,8 @@
 
 [![npm version](https://badge.fury.io/js/swixter.svg)](https://www.npmjs.com/package/swixter)
 [![Test Status](https://github.com/dawnswwwww/swixter/actions/workflows/test.yml/badge.svg)](https://github.com/dawnswwwww/swixter/actions/workflows/test.yml)
-[![Release Status](https://github.com/dawnswwwww/swixter/actions/workflows/release.yml/badge.svg)](https://github.com/dawnswwwww/swixter/actions/workflows/test.yml)
+[![Release Status](https://github.com/dawnswwwww/swixter/actions/workflows/release.yml/badge.svg)](https://github.com/dawnswwwww/swixter/actions/workflows/release.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Version](https://img.shields.io/node/v/swixter.svg)](https://nodejs.org)
 
 > Make AI coding tools effortlessly switchable
 
@@ -12,58 +11,43 @@ A lightweight CLI tool that makes it easy to switch between AI providers for Cla
 
 ## Why Swixter?
 
-Working with AI coding tools shouldn't be complicated. Swixter lets you:
-
 - **Switch providers instantly** - Change between Anthropic, Ollama, or custom APIs with one command
-- **Manage multiple configs** - Keep separate profiles for work, personal, or experimental setups
-- **Support multiple coders** - Works with Claude Code, Codex, Continue, and more
-- **Use command aliases** - Ultra-short commands (`r`, `ls`, `sw`) for maximum productivity
-- **Add custom providers** - Easily integrate any OpenAI-compatible AI service
-- **Stay in control** - All configs stored locally, no cloud dependencies
-- **Web UI** - Browser-based interface for visual configuration management
+- **Automatic failover** - Group profiles by priority, auto-retry on provider failure
+- **Local proxy** - Transparent proxy with circuit breaker, your tools won't even notice a provider goes down
+- **Cloud sync** - Encrypt and sync your profiles across devices with end-to-end encryption
+- **Multiple coders** - Works with Claude Code, Codex, Continue
+- **Web UI** - Browser-based interface for visual management
+- **All local** - Your keys stay on your machine; cloud sync uses client-side encryption
 
 ## Installation
 
-### npm (Recommended)
-
 ```bash
+# npm (Recommended)
 npm install -g swixter
-```
-
-### npx (No Install Needed)
 
-```bash
+# npx (No Install Needed)
 npx swixter --help
 ```
 
-### Platform Support
-
 | Platform | Status | Notes |
 |----------|--------|-------|
-| **Linux** | ✅ Full | Full support |
-| **macOS** | ✅ Full | Full support |
-| **Windows 10/11** | ✅ Full | Requires Node.js 18+; Docker Desktop + WSL2 for E2E tests |
+| **Linux** | Full | |
+| **macOS** | Full | |
+| **Windows 10/11** | Full | Requires Node.js 18+ |
 
 Config stored at:
 - **Linux/macOS**: `~/.config/swixter/`
-- **Windows**: `~/swixter/` (e.g., `C:\Users\YourName\swixter\`)
-
-See [docs/WINDOWS.md](docs/WINDOWS.md) for detailed Windows guide.
+- **Windows**: `~/swixter/`
 
 ## Quick Start
 
 ```bash
-# Interactive mode - guided setup
-swixter
-
-# Or use commands directly
-swixter claude create                    # Create profile
-swixter claude list                     # List profiles
-swixter claude switch my-profile        # Switch profile
-swixter claude apply                    # Apply to Claude Code
-
-# Launch Web UI (browser-based management)
-swixter ui
+swixter                          # Interactive mode
+swixter claude create            # Create profile
+swixter claude list              # List profiles
+swixter claude switch my-profile # Switch profile
+swixter claude apply             # Apply to Claude Code
+swixter ui                       # Launch Web UI
 ```
 
 ## Built-in Providers
@@ -71,338 +55,307 @@ swixter ui
 | Provider | API Type | Description |
 |----------|----------|-------------|
 | **Anthropic** | responses | Official Claude API |
-| **Ollama** | chat | Run Qwen, Llama, and other models locally |
+| **Ollama** | chat | Run models locally |
 | **OpenAI** | chat | OpenAI API |
 | **OpenRouter** | chat | Unified access to 100+ models |
-| **Custom** | chat | Add any OpenAI-compatible API |
-
-## Web UI
+| **Custom** | chat | Any OpenAI-compatible API |
 
-Launch `swixter ui` to open a browser-based interface for managing profiles.
+## Profile Management
 
-### Features
+Profiles are configuration templates containing provider, API key, base URL, and model settings. Each coder maintains its own active profile.
 
-- **Dashboard** - View all coders, switch active profiles, apply configurations
-- **Profiles** - Create, edit, delete configuration profiles
-- **Providers** - Manage custom API providers
-- **Settings** - Import/export configurations
-
-### Running the Web UI
+### Commands (take Claude Code as example)
 
 ```bash
-# Default port (3141)
-swixter ui
-
-# Custom port
-swixter ui --port 8080
+swixter claude create              # Interactive creation (alias: new)
+swixter claude create --quiet --name my --provider anthropic --api-key sk-ant-xxx  # Non-interactive
+swixter claude list                # List profiles (alias: ls)
+swixter claude switch <name>       # Switch active profile (alias: sw)
+swixter claude apply               # Write config to ~/.claude/settings.json
+swixter claude run                 # Run Claude Code with current profile (alias: r)
+swixter claude edit <name>         # Edit profile (alias: update)
+swixter claude current             # Show active profile
+swixter claude delete <name>       # Delete profile (alias: rm)
+swixter claude install             # Install Claude Code CLI
+swixter claude update-cli          # Update CLI (alias: upgrade)
 ```
 
-The UI auto-opens in your browser at `http://localhost:3141`.
+Codex and Qwen/Continue have the same command structure: `swixter codex <command>` / `swixter qwen <command>`.
+
+### Model Configuration
 
-### Web UI Dashboard
+**Claude Code** - set per-profile models:
 
-The Dashboard shows:
-- All installed coders (Claude Code, Codex, Continue)
-- Current active profile per coder
-- Quick profile switching via dropdown
-- One-click Apply to write config to coder's settings file
+```bash
+swixter claude create \
+  --name production \
+  --provider anthropic \
+  --api-key sk-ant-xxx \
+  --anthropic-model claude-sonnet-4-20250514 \
+  --default-haiku-model claude-haiku-4-20250506 \
+  --default-opus-model claude-opus-4-20250514
+```
 
-## Commands
+| Flag | Env Variable | Description |
+|------|-------------|-------------|
+| `--anthropic-model` | `ANTHROPIC_MODEL` | Default model |
+| `--default-haiku-model` | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Haiku model |
+| `--default-opus-model` | `ANTHROPIC_DEFAULT_OPUS_MODEL` | Opus model |
+| `--default-sonnet-model` | `ANTHROPIC_DEFAULT_SONNET_MODEL` | Sonnet model |
 
-### For Claude Code
+**Codex/Qwen** - single model field:
 
 ```bash
-swixter claude create          # Create new profile (alias: new)
-swixter claude list             # List all profiles (alias: ls)
-swixter claude switch <name>    # Switch active profile (alias: sw)
-swixter claude apply            # Apply to Claude Code
-swixter claude run              # Run Claude Code with current profile (alias: r)
-swixter claude edit <name>      # Edit existing profile (alias: update)
-swixter claude current          # Show current active profile
-swixter claude delete <name>    # Delete profile (alias: rm)
-swixter claude install           # Install Claude Code CLI
-swixter claude update-cli        # Update Claude Code CLI (alias: upgrade)
+swixter codex create --name local --provider ollama --model qwen3:32b
 ```
 
-### For Codex
+### Custom Providers
 
 ```bash
-swixter codex create            # Create new profile
-swixter codex list               # List all profiles (alias: ls)
-swixter codex switch <name>      # Switch active profile (alias: sw)
-swixter codex apply              # Apply to Codex (writes ~/.codex/config.toml)
-swixter codex run                # Apply + set env + run codex (alias: r)
-swixter codex edit <name>        # Edit existing profile (alias: update)
-swixter codex current            # Show current active profile
-swixter codex delete <name>      # Delete profile (alias: rm)
-swixter codex install            # Install Codex CLI
-swixter codex update-cli         # Update Codex CLI (alias: upgrade)
+swixter providers add
+swixter providers list
+swixter providers remove <id>
+swixter providers show <id>
 ```
 
-**Two ways to use Codex profiles**:
-
-1. **Quick way** (recommended): `swixter codex r`
-   - Automatically applies profile to config.toml
-   - Sets environment variables
-   - Runs codex in one command
+## Groups (Failover)
 
-2. **Manual way**: `swixter codex apply` → set env vars → `codex`
-   - Good for debugging or custom setups
+Groups are ordered lists of profiles used for **automatic failover**. When one provider fails, the next profile in the group is tried automatically.
 
-### For Qwen/Continue
+### How It Works
 
-```bash
-swixter qwen create            # Create new profile
-swixter qwen list               # List all profiles (alias: ls)
-swixter qwen switch <name>      # Switch active profile (alias: sw)
-swixter qwen apply              # Apply to Continue
-swixter qwen run                # Run Qwen Code with current profile (alias: r)
-swixter qwen edit <name>        # Edit existing profile (alias: update)
-swixter qwen current            # Show current active profile
-swixter qwen delete <name>      # Delete profile (alias: rm)
-swixter qwen install            # Install Qwen Code CLI
-swixter qwen update-cli         # Update Qwen Code CLI (alias: upgrade)
 ```
+Request → Proxy → Profile 1 (Anthropic) → Fail! → Profile 2 (OpenRouter) → Success → Response
+```
+
+Each group defines a priority order. The proxy tries profiles from highest to lowest priority until one succeeds.
 
-### Provider Management
+### Commands
 
 ```bash
-swixter providers list          # List available providers
-swixter providers add            # Add custom provider
-swixter providers remove <id>   # Remove provider
-swixter providers show <id>    # Show provider details
+swixter group create              # Interactive creation (alias: new)
+swixter group list                # List groups (alias: ls)
+swixter group show <name>         # Show group details with profile order (alias: info)
+swixter group edit <name>         # Edit group name and profiles (alias: update)
+swixter group set-default <name>  # Set as default group
+swixter group delete <name>       # Delete group (alias: rm)
 ```
 
-### Configuration
+### Example
 
 ```bash
-swixter ui                      # Launch Web UI
-swixter ui --port <port>        # Launch Web UI on custom port
-swixter export <file>           # Export configs
-swixter export <file> --sanitize # Export without API keys
-swixter import <file>           # Import configs
-swixter import <file> --overwrite # Overwrite existing profiles
-swixter completion bash          # Bash completion
-swixter completion zsh           # Zsh completion
-swixter completion fish          # Fish completion
-```
+# Create profiles for different providers
+swixter claude create --name anthropic-primary --provider anthropic --api-key sk-ant-xxx
+swixter claude create --name openrouter-backup --provider openrouter --api-key sk-or-xxx
+swixter claude create --name ollama-local --provider ollama
+
+# Create a group with failover priority
+swixter group create --name ha-group --profiles anthropic-primary,openrouter-backup,ollama-local
 
-## Model Configuration
+# Set as default
+swixter group set-default ha-group
+```
 
-### Claude Code Models
+### Web UI
 
-Set specific models per profile:
+Manage groups visually with drag-and-drop profile reordering:
 
 ```bash
-swixter claude create \
-  --name production \
-  --provider anthropic \
-  --api-key sk-ant-xxx \
-  --anthropic-model claude-sonnet-4-20250514 \
-  --default-haiku-model claude-haiku-4-20250506 \
-  --default-opus-model claude-opus-4-20250514 \
-  --default-sonnet-model claude-sonnet-4-20250514
+swixter ui   # Open Groups page to create/reorder groups
 ```
 
-| Flag | Environment Variable | Description |
-|------|---------------------|-------------|
-| `--anthropic-model` | `ANTHROPIC_MODEL` | Default model |
-| `--default-haiku-model` | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Haiku model |
-| `--default-opus-model` | `ANTHROPIC_DEFAULT_OPUS_MODEL` | Opus model |
-| `--default-sonnet-model` | `ANTHROPIC_DEFAULT_SONNET_MODEL` | Sonnet model |
+## Proxy
 
-### Codex/Qwen Models
+The local proxy server sits between your AI coding tools and upstream providers, enabling automatic failover, circuit breaking, and unified access.
 
-```bash
-swixter codex create \
-  --name local-ollama \
-  --provider ollama \
-  --base-url http://localhost:11434 \
-  --model qwen3:32b
-```
+### How It Works
 
-## Configuration File
-
-Configs are stored at:
-- **Linux/macOS**: `~/.config/swixter/config.json`
-- **Windows**: `~/swixter/config.json`
-
-```json
-{
-  "profiles": {
-    "my-profile": {
-      "name": "my-profile",
-      "providerId": "anthropic",
-      "apiKey": "sk-ant-xxx",
-      "authToken": "sk-ant-auth-xxx",
-      "baseURL": "https://api.anthropic.com",
-      "models": {
-        "anthropicModel": "claude-sonnet-4-20250514",
-        "defaultHaikuModel": "claude-haiku-4-20250506",
-        "defaultOpusModel": "claude-opus-4-20250514",
-        "defaultSonnetModel": "claude-sonnet-4-20250514"
-      },
-      "envKey": "CUSTOM_API_KEY",
-      "headers": {
-        "X-Custom-Header": "value"
-      },
-      "createdAt": "2024-01-01T00:00:00.000Z",
-      "updatedAt": "2024-01-01T00:00:00.000Z"
-    },
-    "ollama-local": {
-      "name": "ollama-local",
-      "providerId": "ollama",
-      "apiKey": "",
-      "baseURL": "http://localhost:11434",
-      "model": "qwen3:32b"
-    }
-  },
-  "coders": {
-    "claude": {
-      "activeProfile": "my-profile"
-    },
-    "codex": {
-      "activeProfile": "ollama-local"
-    },
-    "qwen": {
-      "activeProfile": ""
-    }
-  }
-}
+```
+┌─────────────┐     ┌──────────────────┐     ┌──────────────┐
+│ Claude Code  │────▶│  Swixter Proxy   │────▶│  Anthropic   │
+│ Codex        │     │  (localhost)      │─ ─ ▶│  OpenRouter  │
+│ Continue     │     │  Circuit Breaker  │─ ─ ▶│  Ollama      │
+└─────────────┘     └──────────────────┘     └──────────────┘
 ```
 
-## Add Custom Providers
+Key capabilities:
 
-```bash
-# Interactive setup
-swixter providers add
+- **Failover** - Tries profiles in group priority order, returns first successful response
+- **Circuit Breaker** - Skips providers that failed 3 consecutive times, auto-recovers after 60s
+- **Streaming** - Transparently forwards SSE/NDJSON streaming responses
+- **Multi-format** - Supports both OpenAI Chat (`/v1/chat/completions`) and Anthropic (`/v1/messages`, `/v1/responses`) APIs
+- **Model Rewriting** - Different providers in a group can use different model names; the proxy rewrites them automatically
 
-# With flags
-swixter providers add \
-  --id openrouter \
-  --name "OpenRouter" \
-  --display-name "OpenRouter" \
-  --base-url "https://openrouter.ai/api/v1" \
-  --auth-type bearer
+### Commands
 
-# Then create a profile using it
-swixter claude create --provider openrouter --api-key sk-or-xxx
+```bash
+# Start proxy as a background service
+swixter proxy start                        # Start with default group
+swixter proxy start --group ha-group       # Start with specific group
+swixter proxy start --port 8080            # Custom port (default: 15721)
+swixter proxy start --daemon               # Run in background
+
+# Stop proxy
+swixter proxy stop                         # Stop default instance
+swixter proxy stop run-15722               # Stop specific instance
+
+# View status
+swixter proxy status                       # Show all running instances
+
+# One-shot: start proxy + run coder tool
+swixter proxy run -- claude                # Proxy + Claude Code
+swixter proxy run -- codex                 # Proxy + Codex
+swixter proxy run --group ha-group -- claude  # With specific group
 ```
 
-## Examples
+### The `proxy run` Command
+
+The easiest way to use the proxy. It:
 
-### Example 1: Switch between work and personal
+1. Starts a temporary proxy instance (on next available port)
+2. Points the coder tool's API URL to the local proxy
+3. Spawns the coder tool
+4. Stops the proxy when the coder exits
 
 ```bash
-# Setup work profile
-swixter claude create --name work --provider anthropic --api-key sk-ant-work-xxx
+swixter proxy run -- claude    # One command, everything automatic
+```
 
-# Setup personal profile
-swixter claude create --name personal --provider anthropic --api-key sk-ant-personal-xxx
+### Circuit Breaker
 
-# Switch to work
-swixter claude sw work && swixter claude apply
+Per-profile circuit breaker prevents wasting time on failing providers:
 
-# Quick run
-swixter claude r
+| State | Behavior | Transition |
+|-------|----------|------------|
+| **Closed** | Requests pass through | 3 consecutive failures → Open |
+| **Open** | Requests skipped | After 60s → Half-Open |
+| **Half-Open** | One probe request allowed | Success → Closed, Failure → Open |
 
-# Switch to personal
-swixter claude sw personal && swixter claude apply
-swixter claude r
+### Monitoring (Web UI)
+
+```bash
+swixter ui   # Proxy page shows live status, request counts, and real-time logs
 ```
 
-### Example 2: Try Qwen locally
+## Web UI
 
 ```bash
-# Add Ollama profile
-swixter qwen create \
-  --name local \
-  --provider ollama \
-  --base-url http://localhost:11434
-
-# Switch and run
-swixter qwen sw local
-swixter qwen r
+swixter ui                # Default port 3141
+swixter ui --port 8080    # Custom port
 ```
 
-### Example 3: Use Codex with local Ollama
+### Pages
 
-```bash
-# Create Codex profile for Ollama
-swixter codex create \
-  --name ollama-local \
-  --provider ollama \
-  --base-url http://localhost:11434
+- **Dashboard** - All coders at a glance, quick switch and apply
+- **Profiles** - CRUD for configuration profiles
+- **Groups** - Manage failover groups with drag-and-drop priority
+- **Proxy** - Start/stop proxy, live logs, status monitoring
+- **Providers** - Manage custom providers
+- **Settings** - Import/export configurations
 
-# Quick way: All-in-one
-swixter codex r
+## Cloud Sync
 
-# Manual way
-swixter codex apply
-export OLLAMA_API_KEY=""
-codex
-```
+Sync your profiles and provider configs across devices with end-to-end encryption. API keys and other sensitive fields are encrypted client-side before uploading — the server never sees plaintext secrets.
 
-### Example 4: Web UI workflow
+### Quick Start
 
 ```bash
-# Launch Web UI
-swixter ui
-
-# In browser:
-# 1. Go to Profiles → Create a new profile
-# 2. Go to Dashboard → Select profile from dropdown
-# 3. Click APPLY to write config
+swixter auth register                    # Create account
+swixter auth login                       # Sign in (password)
+swixter auth login --magic-link          # Sign in via magic link email
+swixter sync push                        # Upload encrypted config to cloud
+swixter sync pull                        # Download and merge from cloud
+swixter sync status                      # Check sync state
 ```
 
-## Shell Completion
-
-Enable auto-completion for faster typing:
-
-### Bash
+### Auth Commands
 
 ```bash
-# Install
-swixter completion bash > ~/.local/share/bash-completion/completions/swixter
-
-# Reload
-source ~/.bashrc
+swixter auth register        # Create a new account
+swixter auth login           # Sign in with email + password
+swixter auth login --magic-link  # Sign in via magic link
+swixter auth logout          # Sign out
+swixter auth status          # Check login status
+swixter auth delete-account  # Delete your account and cloud data
 ```
 
-### Zsh
+### Sync Commands
 
 ```bash
-# Install
-swixter completion zsh > ~/.zfunc/_swixter
+swixter sync push                # Push local config to cloud
+swixter sync push --force-local  # Force push (overwrite remote)
+swixter sync pull                # Pull remote config to local
+swixter sync pull --force-remote # Force pull (overwrite local)
+swixter sync status              # Show sync status and versions
+swixter sync enable              # Enable auto sync
+swixter sync disable             # Disable auto sync
+```
+
+### How It Works
 
-# Reload
-autoload -U compinit && compinit
+```
+Local Config → Derive Encryption Key → Encrypt Sensitive Fields → Upload to Cloud
+                                                                               ↓
+Cloud → Download → Decrypt → Merge with Local Config → Apply
 ```
 
-### Fish
+- **End-to-end encryption**: Sensitive fields (API keys, auth tokens) are encrypted using a key derived from your master password before leaving your machine
+- **Version-based conflict detection**: Local and remote versions are tracked to detect and handle conflicts
+- **Selective push/pull**: Only config and providers data are synced; local-only settings stay untouched
 
-```bash
-# Install
-swixter completion fish > ~/.config/fish/completions/swixter.fish
+## Other Commands
 
-# Reload
-fish
+```bash
+swixter export <file>              # Export configs
+swixter export <file> --sanitize   # Export without API keys
+swixter import <file>              # Import configs
+swixter import <file> --overwrite  # Overwrite existing
+swixter completion bash            # Shell completions (zsh/fish supported)
 ```
 
 ## Command Aliases
 
-Save keystrokes with short aliases:
-
 | Alias | Full Command | Description |
 |-------|-------------|-------------|
 | `r` | `run` | Execute the AI coder |
-| `ls` | `list` | List all profiles |
+| `ls` | `list` | List profiles/groups |
 | `sw` | `switch` | Switch profiles |
-| `rm` | `delete` | Delete profiles |
-| `new` | `create` | Create new profile |
-| `update` | `edit` | Edit existing profile |
+| `rm` | `delete` | Delete profiles/groups |
+| `new` | `create` | Create new |
+| `update` | `edit` | Edit existing |
 | `upgrade` | `update-cli` | Update CLI tool |
 
+## Examples
+
+### Switch between work and personal
+
+```bash
+swixter claude create --name work --provider anthropic --api-key sk-ant-work-xxx
+swixter claude create --name personal --provider anthropic --api-key sk-ant-personal-xxx
+swixter claude sw work && swixter claude apply
+```
+
+### Failover setup: Anthropic primary + OpenRouter backup
+
+```bash
+# Create profiles
+swixter claude create --name primary --provider anthropic --api-key sk-ant-xxx
+swixter claude create --name backup --provider openrouter --api-key sk-or-xxx
+
+# Create failover group
+swixter group create --name failover --profiles primary,backup
+
+# Run with proxy (auto-failover)
+swixter proxy run --group failover -- claude
+```
+
+### Run Codex with local Ollama
+
+```bash
+swixter codex create --name local --provider ollama --base-url http://localhost:11434
+swixter codex r
+```
+
 ## Architecture
 
 ```
@@ -410,45 +363,37 @@ swixter/
 ├── src/
 │   ├── cli/           # CLI command handlers
 │   ├── config/        # Config file management
-│   ├── adapters/      # Coder-specific adapters (Claude, Codex, Continue)
-│   ├── providers/     # Provider presets
+│   ├── adapters/      # Coder adapters (Claude, Codex, Continue)
+│   ├── providers/     # Provider presets + user-defined providers
+│   ├── groups/        # Group management (failover profiles)
+│   ├── proxy/         # Local proxy server (failover, circuit breaker)
+│   ├── auth/          # Cloud auth (register, login, token management)
+│   ├── sync/          # Cloud sync (push, pull, merge, auto-sync)
+│   ├── crypto/        # End-to-end encryption (key derivation, field encryption)
 │   ├── server/        # Web UI API server
 │   └── utils/         # Shared utilities
-├── ui/                # Web UI (React + Vite)
+├── ui/                # Web UI (React + Vite + Tailwind)
 └── tests/             # Unit tests
 ```
 
-**Data Flow**:
-1. `swixter create/switch` → Updates `~/.config/swixter/config.json`
-2. `swixter apply` → Writes to coder config (`~/.claude/settings.json`, etc.)
-3. `swixter run` → Sets env vars + spawns coder CLI
-
 ## Development
 
-Built with modern tools:
-
 ```bash
-# Clone repo
 git clone https://github.com/dawnswwwww/swixter.git
 cd swixter
-
-# Install dependencies
 bun install
+bun run cli:dev      # Dev mode with hot reload
+bun test             # Run tests
+bun run build        # Build all (UI + CLI)
+```
 
-# Run CLI in dev mode (with hot reload)
-bun run cli:dev
-
-# Run tests
-bun test
-
-# Run specific test
-bun test tests/adapters/claude.test.ts
-
-# E2E tests (requires Docker)
-bun run test:e2e
+### Release
 
-# Build
-bun run build
+```bash
+# Update CHANGELOG.md first, then:
+bun run release:patch   # Bug fixes (0.1.0 → 0.1.1)
+bun run release:minor   # Features (0.1.0 → 0.2.0)
+bun run release:major   # Breaking changes (0.1.0 → 1.0.0)
 ```
 
 ## Tech Stack
@@ -459,7 +404,6 @@ bun run build
 | **Language** | TypeScript |
 | **CLI UI** | @clack/prompts |
 | **Validation** | Zod |
-| **Version** | semver |
 | **Web UI** | React + Vite + Tailwind CSS |
 | **Testing** | Bun test, Docker E2E |
 
@@ -467,54 +411,6 @@ bun run build
 
 See [CHANGELOG.md](CHANGELOG.md) for version history.
 
-## Roadmap
-
-- [ ] Profile templates for common setups
-- [ ] Configuration validation and migration tools
-- [x] Web UI for profile management (v0.0.9+)
-- [ ] Cloud sync for profiles (optional, planned)
-
-## Contributing
-
-Contributions welcome!
-
-### Development Setup
-
-```bash
-git clone https://github.com/dawnswwwww/swixter.git
-cd swixter
-bun install
-bun run cli:dev
-bun test
-bun run build
-```
-
-### Release Process
-
-1. Update `CHANGELOG.md` under `[Unreleased]`
-2. Run release command:
-   ```bash
-   bun run release:patch  # Bug fixes (0.0.10 → 0.0.11)
-   bun run release:minor  # Features (0.0.10 → 0.1.0)
-   bun run release:major  # Breaking changes
-   ```
-3. GitHub Actions automatically:
-   - Runs tests on Linux/macOS/Windows
-   - Publishes to npm
-   - Creates GitHub Release with changelog
-
-See [CLAUDE.md](CLAUDE.md) for detailed development documentation.
-
 ## License
 
 MIT License - see [LICENSE](LICENSE)
-
-## Links
-
-- [GitHub](https://github.com/dawnswwwww/swixter)
-- [npm](https://www.npmjs.com/package/swixter)
-- [Issues](https://github.com/dawnswwwww/swixter/issues)
-
----
-
-**Made with ❤️ to make AI coding tools more accessible**