Skip to main content

Crate glass_dev

Crate glass_dev 

Source
Expand description

Glass Development Environment runtime.

This crate owns the resident software-development workspace used by the glass product. Browser intelligence remains provided by the one-way glass-browser dependency.

The interactive TUI separates terminal rendering from workspace work. A snapshot worker hydrates resident projections and executes governed browser, Git, agent, and project operations off the input loop. The UI applies versioned snapshots, keeps drafts and modal state local, and restores the terminal without waiting for an active bounded job.

Desktop destinations are Agent, Code, App, Terminal, Tasks, Git, Debug, and More. The shared composer dock is available on every surface. Per-turn AgentTurnMode is Ask, Plan, or Agent (default Agent). Ask and Plan are fail-closed for mutations. SessionTodoList is the workspace-local Agent checklist persisted at .glass/todos/session.json; it is not the overnight task DAG.

§Public API

DevelopmentWorkspace owns the resident project runtime and its trust boundary. SharedDevelopmentWorkspace is the thread-safe handle used by the TUI, daemon, MCP, and agent services. DevelopmentToolRouter exposes governed tool execution, while PiReadiness and PiSessionRequest describe the managed Pi runtime surface.

The focused browser-only API lives in glass_browser.

The docs.rs page documents the Rust library API. Published pages match the crate version they were built from. Installed command behavior is specified in the CLI reference. Current-checkout TUI behavior is specified in the Development TUI architecture guide.

§Quick start

use glass_dev::DevelopmentWorkspace;

let workspace = DevelopmentWorkspace::open(".")?;
println!("{}", workspace.root().display());

§Modules

agents owns resident Pi scheduling and evidence. browser provides the development browser service. development contains files, editors, processes, language services, and project execution. tools and trust enforce governed operations, while tui and workspace connect those services to the interactive product.

Re-exports§

pub use agents::AgentEvent;
pub use agents::AgentId;
pub use agents::AgentRegistry;
pub use agents::AgentSnapshot;
pub use agents::AgentSpec;
pub use agents::AgentStatus;
pub use agents::ResidentAgentBroker;
pub use browser::BrowserRuntimeState;
pub use browser::BrowserService;
pub use browser::BrowserStartConfig;
pub use customization::Customization;
pub use customization::GlassConfig;
pub use customization::Skill;
pub use experiments::ExperimentComparison;
pub use experiments::ExperimentEvidence;
pub use experiments::ExperimentManager;
pub use experiments::ExperimentRanking;
pub use experiments::ExperimentSnapshot;
pub use experiments::ExperimentState;
pub use experiments::ExperimentTrustPolicy;
pub use experiments::ExperimentWeights;
pub use intelligence::CausalPath;
pub use intelligence::DevelopmentEdge;
pub use intelligence::DevelopmentIntelligence;
pub use intelligence::DevelopmentNode;
pub use intelligence::DevelopmentNodeKind;
pub use intelligence::ObservableDevelopmentEvent;
pub use intelligence::ObservableEventInput;
pub use intelligence::ReplayDiff;
pub use lsp::LanguageServerConfig;
pub use lsp::LanguageService;
pub use lsp::LanguageServiceEvent;
pub use pi_runtime::PINNED_PI_SDK_VERSION;
pub use pi_runtime::PiReadiness;
pub use pi_runtime::PiReadinessComponent;
pub use pi_runtime::PiReadinessState;
pub use pi_runtime::PiSessionRequest;
pub use tasks::CrewWake;
pub use tasks::CrewWakeLiveEvidence;
pub use tasks::CrewWakeMember;
pub use tasks::RetryPolicy;
pub use tasks::TaskBudget;
pub use tasks::TaskEvidence;
pub use tasks::TaskId;
pub use tasks::TaskScheduler;
pub use tasks::TaskSnapshot;
pub use tasks::TaskSpec;
pub use tasks::TaskState;
pub use tasks::VerificationRequirement;
pub use tasks::load_latest_crew_wake;
pub use tasks::persist_crew_wake;
pub use todos::SessionTodo;
pub use todos::SessionTodoList;
pub use todos::TodoStatus;
pub use tools::DevelopmentToolContext;
pub use tools::DevelopmentToolRouter;
pub use trust::LocalTrustDecision;
pub use trust::WorkspaceIdentity;
pub use trust::WorkspaceTrust;
pub use trust::WorkspaceTrustStore;
pub use workspace::AgentTurnMode;
pub use workspace::DevelopmentWorkspace;
pub use workspace::SharedDevelopmentWorkspace;

Modules§

agents
Resident Pi agent scheduling, evidence, and lifecycle control. Glass-owned scheduling for independent resident Pi agent sessions.
browser
Development-browser service owned by the resident workspace worker. Resident browser and workflow ownership for the Glass development workspace.
cli
Command-line argument and dispatch support for Glass Dev. Glass Dev-owned project CLI dispatch.
customization
User and project customization loading. Governed project configuration, skills, hooks, commands, and custom tools.
daemon
Resident development daemon integration. Local authenticated daemon that owns complete development workspaces.
debugger
Debugging and semantic breakpoint support. Resident Debug Adapter Protocol runtime.
development
Files, editors, processes, language services, and project execution. Terminal-native project development runtime.
experiments
Experiment orchestration and comparison. Isolated competing implementations ranked from observable evidence.
external_agents
One-shot adapters for installed external coding agents. One-shot adapters for installed external coding agents.
fim
Configured fill-in-the-middle provider for editor ghosts. Fill-in-the-middle ghosts served by a resident Pi AgentSession.
git
Governed Git workspace operations. Native bounded Git and worktree service for Glass Dev.
github
GitHub status, review, and pull-request shipping operations. GitHub integration through the user’s authenticated gh CLI.
harness
Discovery and safe handoff of installed coding harnesses. Discovery and safe handoff metadata for installed coding harnesses.
intelligence
Development graph and causal intelligence projections. Bounded causal graph and observable development replay.
kernels
Kernel process and runtime integration. Named persistent execution kernels for Glass Dev.
lsp
LSP-facing language service integration. Shared resident language-service ownership for humans and agents.
mcp
MCP server and tool integration. Full-product MCP tools contributed to the browser-owned transport.
pi_runtime
Managed Pi runtime readiness and sessions. Glass-owned host for Pi’s native AgentSession SDK runtime.
tasks
Task scheduling, evidence, and verification requirements. Autonomous, verified task DAG scheduling above resident Pi agents.
testing
Test execution and result collection. Resident test discovery and execution service.
todos
Workspace-local Agent todos persisted at .glass/todos/session.json (not the overnight task DAG). Workspace-local todos for the Glass Agent checklist.
tools
Governed development-tool routing. Governed tool routing into one resident development workspace.
trust
Workspace trust decisions and persistence. Identity-bound workspace trust stored outside repository control.
tui
Interactive Glass Dev terminal application. Decomposed full Glass Dev terminal application.
workspace
Workspace ownership and shared handles. Resident development workspace ownership.

Functions§

dispatch
Dispatch the full Glass Development Environment.