AIOS Glass
A friendly glass layer over the AIOS — run rituals, browse agents, manage spaces, and navigate your vault, all from inside Google Antigravity (or any VS Code-compatible editor).
Glass, not engine. AIOS Glass never reimplements the AIOS. It surfaces and triggers what already exists — your slash commands, your spawn workers, your company/collaborate syncs. The brain stays in the framework; this is the clickable window onto it. The terminal becomes optional, not required.
Install
From Open VSX, in any editor that uses it: Google Antigravity, Cursor, VSCodium, Windsurf. Search AIOS Glass in the Extensions view. It needs The AIOS cloned at ~/aios and Claude Code installed.
Why
The AIOS is powerful but lives behind the terminal: slash commands you type, the spawn wrapper, git pulls. That's a wall for non-developers. AIOS Glass turns each ritual into a button, each argument into a form field, each agent into a click — so anyone can operate their AIOS from a graphical surface.
What you get
- ✨ Ask AIOS — type what you need; Claude matches your ask to the right context & tools in your AIOS — and puts them to work. A first-class button, the
⌘⌥G Q chord, and a fallback in every picker: a search that matches nothing resolves by meaning instead of dead-ending.
- Home dashboard — daily-ritual buttons, contextual nudges, a month/week calendar, and a live Sessions & Terminals hub: status dots that breathe while a session works, per-row interrupt / close-session / kill, one-line rows with duration + project. Cards collapse, reorder (
Alt+↑/↓, Daily pinned), and navigate by keyboard.
- Quick tasks & routines — one-click frequent tasks (agent / command / skill / prompt, with a baked assignment) and routines: ordered task bundles that run as a single session. Searches that find nothing offer Create task.
- AIOS Files — a Finder-style explorer for people who never want to see a developer file tree: big folder tiles, breadcrumbs, single-click to open. Its own activity-bar icon (roomy grid when wide, a Finder list when it's a slim sidebar). A Places sidebar cleanly separates your Vault (notes, calendar, projects), the Framework (agents, skills, plugins, commands), and any Workspace folders you add (repos, drives). Open it from the explorer button in the Home header or
⌘⌥G B.
- Light & dark — the whole surface flips between deep-black and paper-light (same coral) from a header toggle or the cog; terminals stay dark.
⌘⌥G chords + the * palette — 21 shortcuts behind one leader with an on-panel cheat-sheet, plus a wildcard palette that fuzzy-searches everything launchable: sessions, routines, tasks, agents, commands, skills.- Status, live — framework-update badge that re-checks the moment your tracker changes, rate-limit meter, company/collaborate surfaces.
- Guided start + diagnostics — a six-step Getting Started walkthrough on install, and an AIOS Glass output channel where any action failure lands with context (cog → Show logs).
Talking to sessions: the spawn inbox
Sessions and agents reach each other through files in ~/.aios/spawn-inbox/, and Glass is one of the two surfaces that carry them out (the AIOS App is the other). Four verbs, contract 4:
spawn: start a named session, with an optional first tasksend: type a prompt into a session that is already runningkill: close a sessionresume: reopen a closed session with the context it had
Whichever surface is running picks the request up. Add "surface": "glass" or "surface": "app" to choose one. A field Glass cannot honour (cwd, App only) is refused with a dead letter naming it, never carried out somewhere else. The full protocol is the README.md the running surface writes into that folder.
Relationship to Foam
AIOS Glass recommends Foam for the vault-navigation layer — [[wikilinks]] rendering, backlinks, and graph view. It's an optional companion (Glass prompts to install it on first run): Glass works without it, and it's deliberately not a hard extensionDependency so Glass installs cleanly on editors whose engine predates the latest Foam (e.g. stock Antigravity). AIOS Glass adds the operating-system control plane on top:
- Rituals — run
/aios:* commands via native Claude Code
- Calendar — vault-aware daily notes
- Agents — browse + spawn native-Claude workers
- Capabilities — skills / MCPs / plugins
- Spaces —
/company + /collaborate, args as forms
- Status — framework updates + company syncs
- Onboarding — guided walkthrough for a fresh clone
We lean on Foam rather than forking it deliberately — Foam stays the engine and auto-updates upstream; we stay glass. (Soft dependency, not hard: a stuck/old Foam never blocks Glass from activating.)
Develop
npm install
npm run watch # or: npm run compile
Then press F5 ("Run AIOS Glass — Extension Dev Host"). A second editor window opens with your vault loaded and the AIOS activity-bar icon active.
How Rituals work
The Rituals view reads the live plugins/aios/commands/*.md directory of your framework at runtime — it never hardcodes the command list, so anything /aios:update adds shows up automatically. Clicking a ritual launches claude "/aios:<name>" in an integrated terminal. Commands with an argument-hint prompt for arguments first.
Configure the framework location with aiosGlass.frameworkPath (default ~/aios).
License
GPL-2.0-or-later © The AIOS contributors — same license as the AIOS framework.
