glass-dev
glass-dev installs glass, the full terminal-native Glass environment. It
combines the browser control plane from glass-browser with a bounded project
runtime, Ratatui development workspace, local agent harness, MCP server, and
phone-oriented remote cockpit.
Use glass-browser instead when you need only the browser CLI or reusable Rust
library.
Install and diagnose
cargo install glass-dev --locked
glass doctor
glass --help
Chrome or Chromium is needed only for browser-backed operations. Project inspection, files, search, local harness, Task Protocol/Web IR operations, policy preflight, and many diagnostics are browser-free.
Terminal workspace
cd /path/to/project
glass
Desktop mode exposes browser and Development workspaces. The Development view owns a bounded file tree, native editor, PTY processes, diagnostics, actors, timeline, source/runtime graph, diff, replay, and optional Pi/Neovim adapters.
Start from the CLI without opening Chrome:
glass project inspect --root .
glass project files --root .
glass project run check --command "cargo check" --wait --root .
glass project diagnostics src/main.rs --root .
glass project diff --root .
glass agent prompt "read README.md" --root .
Project paths remain inside the canonical root. Reads, buffers, PTY output, events, search results, and retained sessions are bounded. Saves are atomic and actor-attributed. External changes and conflicting edit claims fail closed.
SSH, Mosh, and iPhone
Narrow remote terminals automatically use the phone layout:
glass --tui-layout mobile
Use 1–5 or Tab for Home, Agent, App, Diff, and More. tap opens up to
nine revision-bound semantic targets. Continuous pixels remain off by default.
live on enables an ephemeral terminal-native browser using Herdr-owned
graphics, direct Kitty, or true-color ANSI. live quality data is intended
for constrained links. Herdr is optional but recommended as the persistent PTY
owner for detach/reattach. tmux remains compatible.
The safari command prints the stable full-fidelity iPhone workflow: configure
an SSH local port forward to the loopback-bound development server, then open
the local URL in Safari. Do not expose the development server or Chrome CDP
publicly.
MCP and clients
glass mcp-config --client generic
glass --mcp
MCP uses newline or Content-Length JSON-RPC over stdio. stdout is protocol-
only; diagnostics use stderr. Browser and project tools share one negotiated,
policy-aware server lifecycle. Resident project PTYs remain owned until
explicit detach, eviction, server shutdown, or daemon shutdown.
Repository TypeScript and Python clients provide typed browser/project helpers,
cursor-bounded event subscriptions, cancellation, process-health waits,
reconnect workflows, and mutation-lease scopes. They are not published to npm
or PyPI in the 0.3.2 line.
Agents
The deterministic local harness supports hello, prompt, steering, and bounded tool calls. Optional Pi RPC adds model selection, thinking level, follow-up, abort, and new session. Pi starts with its built-in tools disabled; Glass owns the schema-validating tool gateway and private one-use broker files. Browser tools stay unavailable until an attached Browser Workspace exists.
Prompt text, authored task values, and tool arguments are not stored in raw audit events. Mutating tools require authority and explicit confirmation.
Browser usage
glass --incognito navigate https://example.com
glass observe --level interactive
glass click r7:b42 --expected-revision 7
Observation is structured-first. Screenshots, full DOM, form values, PDFs, and JavaScript evaluation are explicit and policy-sensitive.
Documentation
- Getting started
- Complete feature reference
- Development Runtime
- Mobile and remote development
- CLI reference
- MCP integration
- Complete MCP tool catalog
- Security policy
License: MIT.