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;
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
ghCLI. - 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
AgentSessionSDK 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.