Alpha — Lattice is under active development. APIs and features may change.

Quick Start

npm install -g @cryptiklemur/lattice
lattice

Opens at http://localhost:7654.

git clone https://github.com/cryptiklemur/lattice.git
cd lattice
npm install
npm run dev

Starts Express + Vite on a single port (http://localhost:7654) with HMR.

lattice update

The server also checks for updates automatically and shows a banner in the UI when a new version is available.

Features

Chat & Sessions

Send messages, approve tool use, and monitor context window usage with per-message token counts. Browse, rename, delete, and search sessions with date range filtering and hover previews. Sessions automatically get descriptive titles from the first exchange.

Analytics & Cost Tracking

Track spending, token usage, cache efficiency, and session patterns with 15+ chart types. Set daily cost budgets with configurable enforcement (warning, confirm, or hard block).

Workspace

Open multiple sessions as tabs and switch between them. Split-pane via right-click context menu. Pin important messages with bookmarks — jump between them per-session or browse the global bookmarks view. Per-project tab state persists across navigation.

Press ? for keyboard shortcuts, Ctrl+K for the command palette.

Themes & Settings

23 base16 themes (12 dark, 11 light) with OKLCH color space. Configure MCP servers, environment variables, rules, permissions, and Claude settings through the UI.

Plugin Management

Install, update, and remove Claude Code plugins from the UI. Browse all plugins across registered marketplaces sorted by popularity, view details (skills, hooks, rules, author info), and enable/disable plugins per project.

Infrastructure

• Mesh networking — Connect multiple machines with automatic discovery and session proxying
• MCP servers — Add, edit, and remove at global or project level
• Plugins & skills — Browse marketplaces, install plugins, manage per-project
• Memory management — View and edit Claude's project memories
• Self-updating — Automatic update checks with in-app banner and lattice update CLI

Mobile

Responsive design with touch targets, swipe-to-open sidebar, and optimized layouts.

Architecture

Single npm package with three source directories:

| Directory | Stack | |-----------|-------| | src/shared/ | TypeScript types, message protocol, constants | | src/server/ | Express + ws server, analytics engine, mesh networking | | src/client/ | React 19, Vite, Tailwind, daisyUI, 23 themes |

In development, Vite runs in middleware mode inside Express — single port for API, WebSocket, and HMR. In production, Express serves the built client from dist/client/.

Communication via typed WebSocket messages. Sessions managed through the Claude Agent SDK. Client state via Tanstack Store + Router.

Security

| Feature | Detail | |---------|--------| | Authentication | Passphrase with scrypt hashing, 24-hour token expiration | | Rate limiting | 100 messages per 10-second window per client | | Attachments | 10MB upload limit | | Bash commands | cd boundary-checked against project directory | | Mesh pairing | Tokens expire after 5 minutes | | Shutdown | Graceful drain of active streams |

Testing

npm run dev            # start server
npx playwright test    # run tests

Playwright suite covers onboarding, session flow, keyboard shortcuts, accessibility, message actions, and session previews.

Configuration

| Path | Purpose | |------|---------| | ~/.lattice/config.json | Daemon config (port, name, TLS, projects, cost budget) | | ~/.lattice/bookmarks.json | Message bookmarks across all sessions | | ~/.claude/CLAUDE.md | Global Claude instructions | | ~/.claude.json | Global MCP server configuration |

Environment variables:

• ANTHROPIC_API_KEY — Optional. Uses claude setup-token if not set.
• DEBUG=lattice:* — Structured debug logging.
• Server binds to 0.0.0.0:7654. Override with lattice --port <port>.

Contributing

See CONTRIBUTING.md for development setup, coding standards, and pull request guidelines.

License

MIT