About this project

glosa is an experimental local-first workspace designed to improve the review process when working with AI coding agents like Claude Code and Codex. It provides a dedicated browser-based surface to read and review rendered Markdown, HTML, and text, moving the review process out of the terminal while keeping the agent session active. Key capabilities include: - Review & Annotate: Users can attach feedback to durable source anchors (rather than volatile line numbers), ensuring comments stay attached to the correct text across revisions. - Direct Editing: Allows users to edit source files directly within the interface, which are then saved and re-rendered. - Version History: Maintains a workspace-local shadow repository to track versions and restore checkpoints without affecting the project's actual Git history. - Agent Integration: Supports routing feedback back to agent sessions via hooks and MCP (Model Context Protocol). It can block agent execution until a human provides a verdict via a review request. - Local-First Security: Operates entirely on the local machine with no telemetry, cloud sync, or external runtime calls. Technical requirements include macOS 13+ and Bun 1.2.7+.