@lattices/cli 0.3.0

package/docs/quickstart.md

@@ -0,0 +1,75 @@
+---
+title: Quickstart
+description: Install lattices and launch your first workspace in 2 minutes
+order: 0.5
+---
+
+Four steps to a running workspace.
+
+## 1. Install lattices
+
+```bash
+git clone https://github.com/arach/lattices
+cd lattices && npm link
+```
+
+Verify: `lattices help` should print usage info.
+
+## 2. Launch the menu bar app
+
+```bash
+lattices app
+```
+
+This builds (or downloads) and launches the native macOS companion.
+Open the command palette with **Cmd+Shift+M** to search and launch
+any project, tile windows, or switch workspace layers.
+
+## 3. Add a project config
+
+Drop a `.lattices.json` in your project root:
+
+```bash
+cd ~/your-project
+lattices init
+```
+
+This generates a config like:
+
+```json
+{
+  "panes": [
+    { "name": "claude", "cmd": "claude", "size": 60 },
+    { "name": "server", "cmd": "bun dev" }
+  ]
+}
+```
+
+The menu bar app discovers projects with `.lattices.json` files
+automatically — they show up in the command palette.
+
+## 4. (Optional) Add tmux for persistent sessions
+
+If you want terminal sessions that survive disconnects and auto-restore
+your pane layout:
+
+```bash
+brew install tmux
+cd ~/your-project && lattices
+```
+
+This creates a tmux session with your configured panes side by side.
+The session persists in the background — close your terminal, reopen it,
+run `lattices` again, and everything is still there.
+
+> **Without tmux**, you still get the menu bar app, command palette,
+> window tiling, workspace layers, OCR, and the full agent API.
+
+## What's next
+
+- [Configuration](/docs/config): `.lattices.json` reference and CLI commands
+- [Menu Bar App](/docs/app): command palette, tiling, and settings
+- [Layers & Groups](/docs/layers): organize projects into switchable contexts
+- [Screen OCR](/docs/ocr): let agents read what's on screen
+- [Concepts](/docs/concepts): sessions, panes, and the architecture
+- [Agent API](/docs/api): programmatic control for agents and scripts

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@lattices/cli",
+  "version": "0.3.0",
+  "description": "Agentic window manager for macOS — programmable workspace, smart layouts, managed tmux sessions, and a 35+-method agent API",
+  "bin": {
+    "lattices": "./bin/lattices.js",
+    "lattices-app": "./bin/lattices-app.js"
+  },
+  "keywords": [
+    "tmux",
+    "claude",
+    "dev-server",
+    "developer-tools",
+    "cli",
+    "terminal",
+    "multiplexer"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arach/lattices"
+  },
+  "license": "MIT",
+  "exports": {
+    ".": "./bin/client.js",
+    "./daemon-client": "./bin/daemon-client.js"
+  },
+  "scripts": {
+    "dev": "bun --cwd docs-site dev"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "os": ["darwin"],
+  "files": [
+    "bin",
+    "app/Package.swift",
+    "app/Sources",
+    "app/Lattices.app/Contents/Info.plist",
+    "docs"
+  ]
+}