用途：Glorp 是一个编码智能体，具备 read/write/edit/bash/glob/grep/ls/web_fetch 工具、子智能体与分发网格。Glorp Garage 是配套的多会话 HTTP/WS 控制平面，供程序化驱动，而非供人类交互使用的 TUI。
运行方式：TUI 直接运行 glorp；一次性无头运行使用 glorp -p "…"；需要大量并发、长驻、远程驱动的会话时使用 glorp garage。
安装：需 Bun ≥ 1.3。git clone https://github.com/porkytheblack/glorp && cd glorp；bun install；bun run build（生成 dist/glorp，或 bun run src/cli.ts）。模型提供方密钥通过环境变量设置，如 ANTHROPIC_API_KEY、OPENAI_API_KEY、OPENROUTER_API_KEY、GEMINI_API_KEY、GROQ_API_KEY。
启动 Garage：glorp garage 默认在 http://127.0.0.1:4271（回环、关闭鉴权）；绑定非回环地址则自动要求 API 密钥。可用 --workspace-root 指定沙箱目录。可用 glorp garage keys add/list/revoke 管理密钥。
核心模型：会话拥有独立对话、计划与权限状态；工作区是智能体读写的目录，分为调用方提供的目录与 Garage 自行创建的沙箱。删除会话时加 ?workspace=true 仅清理 workspaceRoot 下无其他会话引用的沙箱，调用方目录始终保留。
接口层面：Garage 提供会话层（细粒度控制、多轮对话、实时流）与 Task API（提交输入、轮询结果）两种操作高度，后者基于前者构建。
主要用法：推荐使用 @porkytheblack/glorp-client 的 configure/run 或 createClient；也可直接调用 REST，端点为 /api/v1/…，包括创建会话、发送消息（可 wait 同步等待）、轮询状态与结果、中止、删除等。WebSocket 事件流支持 send_message、abort、resolve_permission、set_permission_mode、resync 等命令。
权限模式：normal 会就高风险操作提示，需逐一处理权限槽；auto 自动批准安全操作，是无人值守默认；bypass 完全不提示，仅适用于一次性沙箱，不可用于用户真实仓库。
其它能力：每个会话有 uploads/ 文件交换目录；支持会话级临时凭据（仅存内存）；支持多租户命名空间，命名空间可拥有独立的模板库与外部 companion 服务（Git 令牌与模板注册表），模板解析采用继承覆盖、最新优先的规则。
限制：companion 为可选组件，不可用时 Garage 继续提供上次已知可用的目录；会话级凭据在 Garage 重启后需重新提供；资料未提供价格、收费或平台兼容性等信息。