Skip to content
Back to search

agentglass

πŸ›° Every AI coding agent on your machine, on one screen β€” live cost, tokens and tool calls across every provider, and a hold on anything dangerous until you say go. From your desk or your phone.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/SirAllap/agentglass with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/SirAllap/agentglass'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sirallap--agentglass/badge.svg)](/listings/sirallap--agentglass)

HTML

<a href="/listings/sirallap--agentglass"><img src="/api/listings/sirallap--agentglass/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

A desktop app with its own server inside it: nothing to run in a terminal, no port to open in a browser. Take the build for your platform from [**Releases**](https://github.com/SirAllap/agentglass/releases/latest) and launch it.

On macOS the build is not signed yet, so Gatekeeper calls it damaged. It is not: `xattr -dr com.apple.quarantine /Applications/agentglass.app`, once.

Or run it from source:

git clone https://github.com/SirAllap/agentglass && cd agentglass
bun install
AGENTGLASS_STATE_DIR=~/.local/state/agentglass-dev bun run dev   # http://localhost:4000, its own database
python3 hooks/install_hooks.py      # so Claude Code reports to it

Full instructions, every platform's caveats and the requirements it expects to find: [**docs/INSTALL.md**](docs/INSTALL.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 211 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="landing/og.png" alt="agentglass β€” nothing to alt-tab to: terminal, agents, pull requests, diffs, browser, approvals and phone around one window" width="100%" />
  3. **The workspace for your coding agents: their terminals, pull requests, diffs, a browser they can drive and every approval they wait on, in one window on your own machine.**
  4. [![Live demo](https://img.shields.io/badge/β–Ά%20Live%20demo-try%20it%20in%20your%20browser-6366f1?style=for-the-badge)](https://sirallap.github.io/agentglass/demo/)
  5. [![Download](https://img.shields.io/badge/⬇%20Download-Linux%20Β·%20macOS%20Β·%20Windows%20Β·%20Android-238636?style=for-the-badge)](https://github.com/SirAllap/agentglass/releases/latest)
  6. [![release](https://img.shields.io/github/v/release/SirAllap/agentglass?style=flat-square&color=6366f1)](https://github.com/SirAllap/agentglass/releases/latest)
  7. [![stars](https://img.shields.io/github/stars/SirAllap/agentglass?style=flat-square&color=eab308)](https://github.com/SirAllap/agentglass/stargazers)
  8. [![license](https://img.shields.io/github/license/SirAllap/agentglass?style=flat-square&color=10b981)](LICENSE)
  9. <a href="https://trendshift.io/repositories/86777" target="_blank"><img src="https://trendshift.io/api/badge/trendshift/repositories/86777/daily?language=TypeScript" alt="agentglass | Trendshift" width="250" height="55"/></a>
  10. </div>
  11. Running several agents means living in several apps: a terminal per agent, a
  12. browser tab per pull request, an editor for the diff, a chat window for the
  13. permission prompt, and the phone for the one that got stuck while you were
  14. away. agentglass is one desktop window that holds all of it. Claude Code, Codex,
  15. Gemini CLI and OpenCode keep running where they already run β€” in tmux, in your
  16. repositories β€” and everything they touch comes to you there. Nothing to
  17. alt-tab to.
  18. **See it:** [the site](https://sirallap.github.io/agentglass/) walks through it,
  19. and the [live demo](https://sirallap.github.io/agentglass/demo/) is the real
  20. interface running in your browser on sample data.
  21. ## 🧰 Without leaving the window
  22. - **Run your agents.** It attaches to the sessions already open in tmux, and it
  23. can start them: a task or a GitHub issue becomes a worktree, a branch and an
  24. agent working in it, several at once without colliding.
  25. - **Seat an orchestrator.** One agent per project keeps the field in view and
  26. hands work to workers under a policy you set in Settings: which engine sits
  27. in the chair, which ones do the work, what a worker may touch, and the rules
  28. that change that when a plan's quota runs low. Workers start narrow, a push
  29. or a merge is never in their reach, and only you can change the policy. They
  30. run as you, so it is a lock and not a sandbox: [SECURITY.md](SECURITY.md) says
  31. where it stops.
  32. - **Work in real terminals.** Real tmux panes, your tmux windows as tabs, the
  33. project's `make` targets and `package.json` scripts one click away.
  34. - **Answer what is waiting on you.** The **Lantern** leads with who needs you:
  35. red for an agent stopped on a permission gate, amber for one that finished and
  36. is waiting for you to type. A tool call you chose to gate is held until you
  37. allow it, from the desk or the phone, and the queue is on disk, so a crash
  38. cannot silently allow it.
  39. - **Read what the agent wrote.** A diff viewer with word-level changes grouped
  40. by agent and worktree, and a source-control panel to stage hunks, commit,
  41. branch, stash and resolve conflicts.
  42. - **Review pull requests to a verdict.** Checks, conversation, files and an
  43. inline review composer, without opening a browser tab.
  44. - **Give your agents a browser.** A browser panel your agents drive from a CLI
  45. and an MCP server, already signed in to what you are signed in to.
  46. - **Keep the rest in view.** Docker containers and logs, listening ports and
  47. the checkout that owns each one, a file browser, CPU and memory, and what
  48. every session costs and where its time goes.
  49. - **Take it with you.** An Android app paired by a code you scan: the machine's
  50. terminal panes, the approvals waiting on you, pull requests and a checkout's
  51. changes, at a scope you grant.
  52. - **Add what is missing.** Plugins are separate processes with a scoped,
  53. revocable token, installed from an in-app catalogue.
  54. Every view, and what each one is for: [**docs/WORKSPACE.md**](docs/WORKSPACE.md).
  55. ## πŸ’» Platforms
  56. | Platform | Status | You want | Worth knowing |
  57. | --- | --- | --- | --- |
  58. | **Linux** | βœ… Working | `.AppImage` Β· `.deb` | The AppImage needs FUSE 2 (`libfuse2`); without it, start it with `scripts/run-appimage.sh` |
  59. | **macOS** | βœ… Working, unsigned | `.dmg` β€” Apple silicon & Intel | One `xattr` command on first launch, below |
  60. | **Windows** | πŸ§ͺ Not verified on real metal | `.exe` | Builds and passes CI; a confirmation on hardware is [wanted](https://github.com/SirAllap/agentglass/issues/231) |
  61. | **Android** | βœ… Working | `.apk`, signed | Companion app, paired by a code you scan |
  62. ## ⬇️ Install
  63. A desktop app with its own server inside it: nothing to run in a terminal, no
  64. port to open in a browser. Take the build for your platform from
  65. [**Releases**](https://github.com/SirAllap/agentglass/releases/latest) and
  66. launch it.
  67. On macOS the build is not signed yet, so Gatekeeper calls it damaged. It is
  68. not: `xattr -dr com.apple.quarantine /Applications/agentglass.app`, once.
  69. Or run it from source:
  70. ```bash
  71. git clone https://github.com/SirAllap/agentglass && cd agentglass
  72. bun install
  73. AGENTGLASS_STATE_DIR=~/.local/state/agentglass-dev bun run dev # http://localhost:4000, its own database
  74. python3 hooks/install_hooks.py # so Claude Code reports to it
  75. ```
  76. Full instructions, every platform's caveats and the requirements it expects to
  77. find: [**docs/INSTALL.md**](docs/INSTALL.md).
  78. ## πŸ”’ Local, and it stays that way
  79. Your machine holds everything: a SQLite file on your own disk, no account, no
  80. cloud, nothing phoned home. The phone reaches the desk over your own network,
  81. paired by a code you scan, at a scope you choose β€” read, answer, or full.
  82. Two paths leave the machine and both are opt-in and off by default: a webhook
  83. you configure yourself, and the Explain button, which sends the hunks you point
  84. at to a model. Read [**SECURITY.md**](SECURITY.md) before you install: what is
  85. stored, what is exposed, what each token can do, and every switch that turns a
  86. capability off.
  87. ## ❓ FAQ
  88. <details>
  89. <summary><b>Does it replace Claude Code, or my agent?</b></summary>
  90. No. Your agents are the same CLIs you already run. agentglass attaches to the
  91. tmux sessions and repositories already open on your machine, and when it starts
  92. an agent it runs that same CLI, on your machine, with your login. It does not
  93. proxy them β€” close agentglass and every agent in tmux keeps running.
  94. </details>
  95. <details>
  96. <summary><b>Does anything leave my machine?</b></summary>
  97. No account, no cloud, no telemetry. Everything lives in a SQLite file on your
  98. own disk. Two paths can leave and both are off by default: a webhook you
  99. configure yourself, and the Explain button, which sends the hunks you point at
  100. to a model. [SECURITY.md](SECURITY.md) lists every switch.
  101. </details>
  102. <details>
  103. <summary><b>What do I actually need installed?</b></summary>
  104. **Needed:** git, the Claude Code CLI, and Python 3.
  105. **Per feature:** tmux (agents as live panes, your tmux windows as tabs, theme
  106. sync), the GitHub CLI (the pull-requests panel β€” and logged in, which is the
  107. step people miss), Docker (containers, images, volumes, logs).
  108. Settings β–Έ Requirements checks all of it on your machine and says what stands
  109. down without each one.
  110. </details>
  111. <details>
  112. <summary><b>Why does macOS say the app is damaged?</b></summary>
  113. It is not damaged β€” the build is not signed yet, and Gatekeeper says that about
  114. anything unsigned. Once: `xattr -dr com.apple.quarantine /Applications/agentglass.app`.
  115. Signing and notarization are not done yet.
  116. </details>
  117. <details>
  118. <summary><b>Which agents, and which providers?</b></summary>
  119. **Agents:** Claude Code, Codex, Gemini CLI and OpenCode.
  120. **Providers**, for pointing Claude Code at something else: Kimi, OpenAI, Gemini
  121. and Bedrock β€” see [docs/INSTALL.md](docs/INSTALL.md).
  122. </details>
  123. ## πŸ“š Documentation
  124. | | |
  125. | --- | --- |
  126. | [**INSTALL.md**](docs/INSTALL.md) | Installing, updating, requirements, the desktop app, the control plane, and running against any provider β€” Kimi, OpenAI, Gemini, Bedrock |
  127. | [**WORKSPACE.md**](docs/WORKSPACE.md) | Every view and what it is for: the rail, the Clone, the Agents screen, the terminal, keyboard shortcuts, themes |
  128. | [**CONFIG.md**](docs/CONFIG.md) | Every environment variable the code reads, the whole HTTP API, and the architecture |
  129. | [**CLEANUP.md**](docs/CLEANUP.md) | What happens to the local leftovers of a merged PR: the four modes, `agentglass-cleanup`, the safety blocks, what is never touched, and the per-project settings |
  130. | [**POLARIS.md**](docs/POLARIS.md) | The orchestrator's pull request abilities: the classes, the 17 doors and three presets, the guardrails, Assisted setup, and how an agent changes them with `agentglass-ui settings` |
  131. | [**SECURITY.md**](SECURITY.md) | The trust model, what each surface can reach, retention, and how to report a vulnerability |
  132. | [**EXTENDING.md**](docs/EXTENDING.md) | Driving agentglass from your own harness, and writing a plugin |
  133. | [**PLUGINS.md**](docs/PLUGINS.md) | What a plugin is, what it may ask for, and how to publish one |
  134. | [**CHANGELOG.md**](CHANGELOG.md) | What each release changed |
  135. | [**AGENTS.md**](AGENTS.md) | The short version for an agent: driving the built-in browser from a session, and working in this repository. `llms.txt` on the site is the same index for a model |
  136. ## 🧩 Two things worth knowing about
  137. **Worktrees start with what git leaves out.** `git worktree add` copies the
  138. tracked tree and nothing else β€” no `.env`, no local settings β€” and a new
  139. checkout does not start without them. A `.worktreeinclude` at the repository
  140. root names the ignored paths every worktree agentglass cuts should carry in.
  141. **The terminal has two keyboard tricks.** `Ctrl+Shift+Space` letters the paths,
  142. links, hashes and ids on a pane's screen so one key pastes one back. And
  143. selecting something in a pane offers to ask the agent in that pane about it.
  144. ## πŸ’¬ Community
  145. [![Discussions](https://img.shields.io/badge/Discussions-ask%20anything-6366f1?style=flat-square)](https://github.com/SirAllap/agentglass/discussions)
  146. [![Issues](https://img.shields.io/github/issues/SirAllap/agentglass?style=flat-square&color=238636&label=Issues)](https://github.com/SirAllap/agentglass/issues)
  147. [![help wanted](https://img.shields.io/badge/help%20wanted-start%20here-eab308?style=flat-square)](https://github.com/SirAllap/agentglass/labels/help%20wanted)
  148. ## 🀝 Contributing
  149. Issues and PRs welcome β€” see [CONTRIBUTING.md](CONTRIBUTING.md). Small, fast and
  150. dependency-light on purpose: a Bun/SQLite server, a React/Vite UI, an Electron
  151. desktop shell, a React Native phone app, and a stdlib-only Python hook
  152. forwarder. To adapt it to another agent or harness without forking, start at
  153. [`docs/EXTENDING.md`](docs/EXTENDING.md).
  154. ## About
  155. Built by [**@SirAllap**](https://github.com/SirAllap) (David Pallares).
  156. The upstream project, with its releases and issues, lives at
  157. [github.com/SirAllap/agentglass](https://github.com/SirAllap/agentglass).
  158. Not affiliated with or endorsed by Anthropic; "Claude" and "Claude Code" are
  159. trademarks of Anthropic.
  160. ## License
  161. MIT Β© 2026 David Pallares β€” see [LICENSE](LICENSE).
  162. The icons the file manager borrows from Strata carry their own notices in
  163. [**NOTICE.md**](NOTICE.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.