feat: update README to enhance feature descriptions and add screenshot

Author: nolikzero

README.md

@@ -1,7 +1,8 @@
 # BetterCode
 
-A local-first Electron desktop app for AI-powered code assistance with multi-provider support.
+**UI for parallel work with AI agents** -- a local-first Electron desktop app for AI-powered code assistance with multi-provider support.
 
+[![Version](https://img.shields.io/badge/version-0.0.6-blue)]()
 [![macOS](https://img.shields.io/badge/macOS-supported-brightgreen)]()
 [![Linux](https://img.shields.io/badge/Linux-supported-brightgreen)]()
 [![Windows](https://img.shields.io/badge/Windows-experimental-yellow)]()
@@ -11,104 +12,129 @@ A local-first Electron desktop app for AI-powered code assistance with multi-pro
 
 ---
 
-<!-- Screenshot placeholder: Add main app interface screenshot here -->
-<!-- ![BetterCode Screenshot](docs/screenshots/main-interface.png) -->
+![BetterCode Screenshot](screenshot.png)
 
-## Screenshots
+## Features
 
-<!-- Add screenshots to docs/screenshots/ and uncomment the relevant lines -->
+### AI-Powered Coding
 
-| Main Chat Interface | Terminal Integration |
-|:---:|:---:|
-| <!-- ![Chat](docs/screenshots/chat-interface.png) --> *Chat interface placeholder* | <!-- ![Terminal](docs/screenshots/terminal.png) --> *Terminal placeholder* |
+- **Multi-Provider Support** -- Use Claude, OpenAI Codex, or OpenCode as your AI backend
+- **Plan and Agent Modes** -- Switch between read-only analysis (Plan) and full code execution permissions (Agent)
+- **Ralph Mode** -- Autonomous coding sessions with minimal user input
+- **Session Resume** -- Continue conversations across app restarts with full context preservation
 
-| Git Changes View | Project Selector |
-|:---:|:---:|
-| <!-- ![Changes](docs/screenshots/changes-view.png) --> *Changes view placeholder* | <!-- ![Projects](docs/screenshots/project-selector.png) --> *Project selector placeholder* |
+### Development Tools
 
-## Features
+- **Integrated Terminal** -- Full xterm-based terminal with multiple panes and session persistence
+- **Real-time Tool Execution** -- Watch bash commands, file edits, and web searches execute live
+- **Git Worktree Isolation** -- Each chat session runs in its own isolated Git worktree for safe experimentation
+- **Change Tracking** -- Visual diffs, file change tracking, and PR management
+
+### Project Management
+
+- **Project Linking** -- Link local folders with automatic Git remote detection for GitHub, GitLab, and Bitbucket
+- **VSCode Theme Support** -- Import and apply your favorite VSCode themes with builtin theme options
+- **Cross-Platform** -- Native builds for macOS, Linux, and Windows (experimental)
 
-- **AI Chat Modes** - Switch between Plan mode (read-only analysis) and Agent mode (full code execution permissions)
-- **Multi-Provider Support** - Use Claude, OpenAI Codex, or OpenCode as your AI backend
-- **Project Management** - Link local folders with automatic Git remote detection for GitHub, GitLab, and Bitbucket
-- **Git Worktree Isolation** - Each chat session runs in its own isolated Git worktree for safe experimentation
-- **Real-time Tool Execution** - Watch bash commands, file edits, and web searches execute live
-- **Integrated Terminal** - Full xterm-based terminal with multiple panes and session persistence
-- **Change Tracking** - Visual diffs, file change tracking, and PR management
-- **Session Resume** - Continue conversations across app restarts with full context preservation
-- **VSCode Theme Support** - Import and apply your favorite VSCode themes
+### Privacy
+
+- **Zero Analytics** -- No telemetry, no data collection, fully local-first
 
 ## Installation
 
-### Option 1: Download Release
+### Download Release
+
+Download the latest release for your platform from the [Releases](https://github.com/Nolikzero/better-code/releases) page.
 
-Download the latest release for your platform from the [Releases](https://github.com/21st-dev/1code/releases) page.
+| Platform | Formats |
+|----------|---------|
+| macOS (Apple Silicon) | DMG, ZIP |
+| Linux (x64, arm64) | AppImage, DEB, RPM |
+| Windows (x64) | NSIS installer |
 
-### Option 2: Build from Source
+### Build from Source
 
 **Prerequisites:**
 - [Bun](https://bun.sh/) package manager
 - Node.js 18+ (for native module compilation)
-- Platform-specific:
-  - **macOS**: Xcode Command Line Tools (`xcode-select --install`)
-  - **Linux**: Build essentials (`build-essential`, `python3`)
-  - **Windows**: Visual Studio Build Tools
+- **macOS**: Xcode Command Line Tools (`xcode-select --install`)
+- **Linux**: Build essentials (`build-essential`, `python3`)
+- **Windows**: Visual Studio Build Tools
 
 ```bash
-git clone https://github.com/21st-dev/1code.git
-cd 1code
+git clone https://github.com/Nolikzero/better-code.git
+cd better-code
 bun install
 bun run build
 bun run package:mac      # or package:win, package:linux
 ```
 
-### Option 3: Development Setup
+### Development Setup
 
 ```bash
-git clone https://github.com/21st-dev/1code.git
-cd 1code
+git clone https://github.com/Nolikzero/better-code.git
+cd better-code
 bun install
 bun run dev              # Start with hot reload
 ```
 
 ## Quick Start
 
-1. **Launch the app** - Open BetterCode after installation
-2. **Complete onboarding** - Sign in with your Claude account or configure your preferred AI provider
-3. **Add a project** - Click "Add Project" and select a local folder (Git repos are auto-detected)
-4. **Start chatting** - Choose Plan or Agent mode and begin your coding session
+1. **Launch the app** -- Open BetterCode after installation
+2. **Complete onboarding** -- Sign in with your Claude account or configure your preferred AI provider
+3. **Add a project** -- Click "Add Project" and select a local folder (Git repos are auto-detected)
+4. **Start chatting** -- Choose Plan or Agent mode and begin your coding session
 
 ## Architecture
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
 │                    Electron Application                      │
 ├─────────────────┬─────────────────┬─────────────────────────┤
-│   Main Process  │     Preload     │    Renderer Process     │
-│   (Node.js)     │   (IPC Bridge)  │       (React 19)        │
+│  Main Process   │     Preload     │   Renderer Process      │
+│  (Node.js)      │  (IPC Bridge)   │      (React 19)         │
 ├─────────────────┼─────────────────┼─────────────────────────┤
-│ • tRPC Routers  │ • Context       │ • Tailwind CSS          │
-│ • SQLite DB     │   Isolation     │ • Radix UI Components   │
-│ • Git Ops       │ • desktopApi    │ • Jotai/Zustand State   │
-│ • AI Providers  │   Exposure      │ • React Query           │
-│ • Terminal PTY  │                 │ • xterm Terminal        │
+│ • tRPC Routers  │ • Context       │ • Tailwind CSS 4        │
+│   (15 routers)  │   Isolation     │ • Radix UI Components   │
+│ • SQLite +      │ • desktopApi    │ • Jotai + Zustand       │
+│   Drizzle ORM   │   Exposure      │ • React Query           │
+│ • Git Ops +     │                 │ • xterm Terminal        │
+│   Worktrees     │                 │ • Shiki Highlighting    │
+│ • AI Providers  │                 │                         │
+│   (3 providers) │                 │                         │
+│ • Terminal PTY  │                 │                         │
 └─────────────────┴─────────────────┴─────────────────────────┘
 ```
 
 For detailed architecture documentation, see [CLAUDE.md](CLAUDE.md).
 
+## AI Providers
+
+BetterCode supports multiple AI backends through a unified provider interface:
+
+| Provider | SDK | Description |
+|----------|-----|-------------|
+| Claude | `@anthropic-ai/claude-agent-sdk` | Anthropic Claude with full tool use |
+| Codex | `@openai/codex-sdk` | OpenAI Codex for code generation |
+| OpenCode | `@opencode-ai/sdk` | OpenCode AI provider |
+
+Providers can be switched per-chat and support both Plan mode (read-only) and Agent mode (full execution permissions).
+
 ## Tech Stack
 
-| Layer | Technologies |
-|-------|--------------|
-| Desktop | Electron, electron-vite, electron-builder |
-| Frontend | React 19, TypeScript, Tailwind CSS |
-| Components | Radix UI, Lucide icons, Motion |
-| State | Jotai, Zustand, React Query |
-| Backend | tRPC, Drizzle ORM, better-sqlite3 |
-| AI | Claude SDK, Codex SDK, Vercel AI SDK |
-| Terminal | xterm, node-pty |
-| Git | simple-git |
+| Layer | Technologies | Version |
+|-------|--------------|---------|
+| Desktop | Electron, electron-vite, electron-builder | 40.0.0 |
+| Frontend | React, TypeScript, Tailwind CSS | 19.2.3, 5.9.3, 4.1.18 |
+| Components | Radix UI, Lucide icons, Motion | -- |
+| State | Jotai, Zustand, React Query | 2.16.2, 5.0.10, 5.x |
+| Backend | tRPC, Drizzle ORM, better-sqlite3 | 11.8.1, 0.45.1, 12.x |
+| AI | Claude Agent SDK, Codex SDK, OpenCode SDK, Vercel AI SDK | -- |
+| Terminal | xterm, node-pty | 6.0.0, 1.1.0 |
+| Code | Shiki (syntax highlighting) | 3.21.0 |
+| Git | simple-git | 3.30.0 |
+| Linting | Biome | 2.3.11 |
+| Package Manager | Bun | -- |
 
 ## Development
 
@@ -120,9 +146,10 @@ For detailed architecture documentation, see [CLAUDE.md](CLAUDE.md).
 | `bun run build` | Production build |
 | `bun run package:mac` | Package for macOS (DMG + ZIP) |
 | `bun run package:win` | Package for Windows (NSIS) |
-| `bun run package:linux` | Package for Linux (AppImage + DEB) |
+| `bun run package:linux` | Package for Linux (AppImage, DEB, RPM) |
 | `bun run db:generate` | Generate database migrations |
 | `bun run db:push` | Push schema directly (dev only) |
+| `bun run db:studio` | Open Drizzle Studio for database inspection |
 | `bun run lint` | Run Biome linter |
 | `bun run format` | Format code with Biome |
 | `bun run typecheck` | TypeScript type checking |
@@ -131,25 +158,19 @@ For detailed architecture documentation, see [CLAUDE.md](CLAUDE.md).
 
 BetterCode uses SQLite with Drizzle ORM. The database is stored at `{userData}/data/agents.db` and migrations run automatically on startup.
 
-```bash
-bun run db:generate  # Generate migrations after schema changes
-bun run db:studio    # Open Drizzle Studio for database inspection
-```
-
 ## Documentation
 
-- [Architecture Guide](CLAUDE.md) - Detailed codebase structure and patterns
-- [Apple Signing Setup](docs/apple-signing-setup.md) - macOS code signing and notarization
-- [Contributing Guide](CONTRIBUTING.md) - How to contribute to BetterCode
+- [Architecture Guide](CLAUDE.md) -- Detailed codebase structure, patterns, and development reference
+- [Contributing Guide](CONTRIBUTING.md) -- How to contribute to BetterCode
 
 ## Contributing
 
 Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ```bash
 # Fork and clone the repo
-git clone https://github.com/YOUR_USERNAME/1code.git
-cd 1code
+git clone https://github.com/YOUR_USERNAME/better-code.git
+cd better-code
 
 # Install dependencies
 bun install
@@ -160,10 +181,6 @@ git checkout -b feature/your-feature
 # Make changes, then submit a PR
 ```
 
-## Attribution
-
-BetterCode is derived from [21st-dev/1code](https://github.com/21st-dev/1code), licensed under the Apache License 2.0.
-
 ## License
 
-Apache License 2.0 - see [LICENSE](LICENSE) for details.
+Apache License 2.0 -- see [LICENSE](LICENSE) for details.