📝 Rewrite README to reflect full feature set

Author: arach

README.md

@@ -4,9 +4,12 @@
 
 # lattices
 
-Declarative tmux sessions for developers.
+macOS workspace manager. Menu bar app, CLI, and a WebSocket API
+so your AI agents can control the desktop.
 
-One command to create a named tmux session with your tools running. Auto-detects your stack, fully configurable with `.lattices.json`, and a native macOS menu bar app.
+Window tiling, project discovery, workspace layers, on-screen OCR,
+and optionally tmux-powered persistent sessions. 30 RPC methods
+over WebSocket. One JSON config file.
 
 ## Install
 
@@ -17,19 +20,45 @@ npm install -g @arach/lattices
 ## Quick start
 
 ```sh
-cd my-project
-lattices
+# Launch the menu bar app
+lattices app
+
+# Open the command palette from anywhere
+# Cmd+Shift+M
+```
+
+The app scans your projects, tiles windows, and gives you a command
+palette for everything. Add tmux if you want persistent terminal
+sessions:
+
+```sh
+brew install tmux
+cd my-project && lattices
 ```
 
-That's it. lattices creates a tmux session named after your project with Claude Code on the left and your dev server on the right. It detects your package manager and dev command automatically.
+That creates a tmux session with Claude Code on the left and your
+dev server on the right. Detach, close your laptop, come back later,
+reattach. Everything is where you left it.
+
+## What it does
+
+**Menu bar app** sits in your menu bar. Command palette, window tiling,
+project discovery, workspace layers, OCR, and the daemon API. Works
+with or without tmux.
+
+**CLI** for tiling, session management, OCR queries, and tab groups.
 
-## How it works
+**Daemon API** on `ws://127.0.0.1:9399`. 30 RPC methods and 5
+real-time events. Agents can discover projects, tile windows, launch
+sessions, switch layers, and read on-screen text.
 
-1. **Run `lattices`** in any project directory
-2. A named tmux session is created with configured panes
-3. Commands start running in each pane immediately
-4. Detach with `Ctrl+b d`, reattach by running `lattices` again
-5. Sessions persist in the background until you kill them
+```js
+import { daemonCall } from '@arach/lattices/daemon-client'
+
+const windows = await daemonCall('windows.list')
+await daemonCall('session.launch', { path: '/Users/you/dev/frontend' })
+await daemonCall('window.tile', { session: 'frontend-a1b2c3', position: 'left' })
+```
 
 ## Configuration
 
@@ -46,111 +75,93 @@ Drop a `.lattices.json` in your project root:
 }
 ```
 
-### Pane options
-
-| Field  | Description                              |
-|--------|------------------------------------------|
-| `name` | Label for the pane (for your reference)  |
-| `cmd`  | Command to run in the pane               |
-| `size` | Width % for the first pane (default: 60) |
-
-### Session options
-
-| Field     | Description                                                                 |
-|-----------|-----------------------------------------------------------------------------|
-| `ensure`  | Auto-restart exited commands on reattach                                    |
-| `prefill` | Type exited commands into panes on reattach without running (you hit Enter) |
+Or skip it. Without a config, lattices reads your `package.json` and
+picks the right dev command automatically.
 
 ### Layouts
 
 ```
-2 panes — side-by-side          3+ panes — main-vertical
-
-┌──────────┬─────────┐         ┌──────────┬─────────┐
-│  claude   │ server  │         │  claude   │ server  │
-│  (60%)   │ (40%)   │         │  (60%)   ├─────────┤
-└──────────┴─────────┘         │          │ tests   │
-                                └──────────┴─────────┘
-```
-
-## Auto-detection
+2 panes              3+ panes
 
-Without a config file, lattices reads your `package.json` and picks the right command:
-
-- Checks `scripts.dev`, `scripts.start`, `scripts.serve`, `scripts.watch`
-- Detects package manager from lock files (pnpm, bun, yarn, npm)
-- Falls back to a shell if no dev command is found
-
-## Menu bar app
-
-A macOS companion app for managing sessions without touching the terminal.
-
-```sh
-lattices app          # Launch (builds from source or downloads binary)
-lattices app build    # Force rebuild from source
-lattices app quit     # Stop the menu bar app
+┌──────────┬───────┐ ┌──────────┬───────┐
+│  claude  │server │ │  claude  │server │
+│  (60%)   │(40%)  │ │  (60%)   ├───────┤
+└──────────┴───────┘ │          │tests  │
+                     └──────────┴───────┘
 ```
 
-Features:
-- See all projects and their session status at a glance
-- Launch, attach, or detach sessions with a click
-- **Command palette** (`Cmd+Shift+M`): Raycast-style launcher for all actions — fuzzy search, keyboard navigation, instant access to projects, window tiling, and settings
-- Auto-scans your project directories
-- Built with SwiftUI, runs natively on macOS
-
-The app tries to compile from source first (requires Xcode CLI tools), falling back to a pre-built arm64 binary from GitHub releases.
+## Workspace layers
 
-## Tab groups
+Group projects into switchable contexts. `Cmd+Option+1` tiles your
+frontend and API side by side. `Cmd+Option+2` switches to the mobile
+stack. All sessions stay alive across switches.
 
-Bundle related projects as tabs within a single terminal window.
 Configure in `~/.lattices/workspace.json`:
 
 ```json
 {
-  "name": "my-setup",
-  "groups": [
+  "layers": [
     {
-      "id": "talkie",
-      "label": "Talkie",
-      "tabs": [
-        { "path": "/Users/you/dev/talkie-ios", "label": "iOS" },
-        { "path": "/Users/you/dev/talkie-web", "label": "Website" },
-        { "path": "/Users/you/dev/talkie-api", "label": "API" }
+      "id": "web", "label": "Web",
+      "projects": [
+        { "path": "/Users/you/dev/frontend", "tile": "left" },
+        { "path": "/Users/you/dev/api", "tile": "right" }
       ]
     }
   ]
 }
 ```
 
-Each tab gets its own tmux window with pane layout from its `.lattices.json`.
+## Tab groups
+
+Bundle related repos as tabs in one session. Each tab gets its own
+pane layout from its `.lattices.json`.
 
 ```sh
-lattices groups            # List groups with status
-lattices group talkie      # Launch or attach
-lattices tab talkie iOS    # Switch to a tab
+lattices group talkie      # Launch iOS, macOS, Web, API as tabs
+lattices tab talkie iOS    # Switch to the iOS tab
 ```
 
-Groups can also be referenced in [workspace layers](https://lattices.dev/docs/layers) to tile a whole group into a screen position.
+## Screen OCR
+
+The app reads text from visible windows using Apple Vision and indexes
+it with FTS5 full-text search. Agents can search for error messages,
+read terminal output, or find content across all your windows.
+
+```js
+await daemonCall('ocr.scan')
+const errors = await daemonCall('ocr.search', { query: 'error OR failed' })
+```
 
-## CLI reference
+## CLI
 
 ```
-lattices                    Create or reattach to a session for the current project
-lattices init               Generate a .lattices.json config
-lattices ls                 List active tmux sessions
-lattices kill [name]        Kill a session (defaults to current project)
-lattices group [id]         List tab groups or launch/attach a group
-lattices groups             List all tab groups with status
-lattices tab <group> [tab]  Switch tab within a group (by label or index)
-lattices app                Launch the menu bar companion app
+lattices                    Create or reattach to session
+lattices init               Generate .lattices.json
+lattices ls                 List active sessions
+lattices kill [name]        Kill a session
+lattices tile <position>    Tile frontmost window
+lattices group [id]         Launch or attach a tab group
+lattices tab <group> [tab]  Switch tab within a group
+lattices ocr                View current OCR snapshot
+lattices ocr search <query> Search OCR history
+lattices app                Launch the menu bar app
 lattices help               Show help
 ```
 
 ## Requirements
 
-- **tmux** — `brew install tmux`
-- **Node.js** 18+
-- **macOS** (the CLI is macOS-only, the menu bar app requires arm64)
+- macOS 13.0+
+- Node.js 18+
+
+### Optional
+
+- tmux for persistent terminal sessions (`brew install tmux`)
+- Swift 5.9+ to build the menu bar app from source
+
+## Docs
+
+Full documentation at [lattices.dev/docs](https://lattices.dev/docs/overview).
 
 ## License
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arach/lattices",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "macOS workspace manager with window tiling, OCR, and a 30-method daemon API for AI agents",
   "bin": {
     "lattices": "./bin/lattices.js",