Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@cryptiklemur/lattice) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Lattice Dashboard

Lattice

Multi-machine agentic dashboard for Claude Code.
Monitor sessions, manage projects, track costs, and orchestrate across mesh-networked nodes.

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

Quick Start

npm install -g @cryptiklemur/lattice
lattice

Opens at http://localhost:7654.

Development setup

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.

Updating

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.

Chat View

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).

Analytics

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.

Keyboard Shortcuts

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.

Settings

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