Live sessions on every surface
Watch every prompt, tool call, and diff stream in real time — desktop, web portal, iOS and Android. The session runs on your machine; the view follows you.
Your agents. Your environment.
Google Gemini,on every machine you own.
Glueprint spawns the same gemini CLI you already run — your Google login, your config — and adds what the terminal can't: live sessions on every device, approvals from your phone, parallel worktrees, schedules, and memory.
Your provider account. Your code. A workspace to bring them together.
AG-401The integration01 / 05
Your chosen agent.A shared workspace.
Gemini CLI connects over the open Agent Client Protocol — the integration path Google ships in the CLI itself — with first-class detection and capabilities in Glueprint.
Everything below works with the Gemini CLI you have today — no migration, no new account for the model, no lock-in. Uninstall Glueprint and your terminal workflow is exactly as it was.
Note
First-class, over an open protocolGemini CLI speaks ACP natively. Glueprint drives the protocol's client side while Gemini keeps its own authentication, model access, and configuration.
AG-402Install & connect02 / 05
Make it part ofyour next project.
Set up the integration on each machine where the agent will run.
- 01
Install and authenticate Gemini CLI
Install the official package on every host where sessions should run, then complete Gemini's own authentication flow.
- 02
Detect the CLI in Glueprint
Open Settings -> Agents -> Gemini. Leave CLI Path on Auto-detect, choose Detect, and confirm the resolved path and version.
- 03
Start an ACP session
Open a project or worktree, create a session, choose Gemini, and use the capabilities reported by the connected CLI.
Terminal - install and verify
npm install -g @google/gemini-cli
gemini --versionThe process stays on its host. Remote access follows your Glueprint plan and the capabilities of the installed agent.
Help with agent setupAG-403How it works03 / 05
A direct connection.A shared view of the work.
Glueprint adds the workspace around the agent. Its provider account and configuration stay with the CLI.
- 01
It runs your Gemini CLI, not a fork
Glueprint finds the gemini binary you already installed, probes the version, and spawns it. Your Google login or API key and your configuration come along, because it's the same CLI you run in the terminal.
- 02
First-class, over an open protocol
Gemini CLI speaks the Agent Client Protocol natively, so Glueprint drives it the way Google intended: JSON-RPC 2.0 over stdio. Gemini gets first-class detection, a curated capability profile, and its own brand treatment across every surface.
- 03
Output streams as structure
Message chunks, tool calls, and tool-call updates arrive as protocol notifications and render as a live, typed timeline — watchable from desktop, browser, or phone instead of terminal scrollback.
- 04
Permission requests become approval cards
When Gemini asks to write a file or run a command, the protocol's permission request surfaces as an inline approval card on whatever device you're holding. Approve, deny, or auto-allow per tool.
AG-404Compatibility04 / 05
Know what’savailable.
Some features come from Glueprint. Others depend on what the installed agent supports or reports when it connects.
| Capability | Status | Behavior |
|---|---|---|
| Structured session stream | Supported | ACP messages and tool-call updates render in the shared timeline. |
| Permission responses | Runtime | Available when the connected Gemini build advertises protocol approvals. |
| Models and modes | Runtime | Provider/model and mode options are discovered during initialization. |
| Slash commands | Runtime | Shown when Gemini reports command discovery support. |
| Session load or resume | Runtime | Availability depends on the installed Gemini version. |
| Image input | Runtime | Enabled only when advertised by the connected build. |
| Reasoning-effort control | Not exposed | The ACP adapter does not add a separate reasoning-effort knob. |
Check the connected agent for its available models, modes, and permissions. Learn about ACP
AG-405Ownership & limits05 / 05
Your tools.Clear boundaries.
Credentials and model access follow the provider. Glueprint brings the surrounding work into one place.
Glueprint surface
Approve from your phone
Permission prompts arrive as approval cards wherever you are. Kick off a refactor at your desk, approve the file writes from the couch.
Glueprint surface
Parallel sessions across worktrees
Run several Gemini sessions side by side, each in its own git worktree. Built-in worktree management, diffs, and a three-pane conflict resolver keep them from stepping on each other.
Glueprint surface
One screen, many machines
Tile Gemini sessions from your laptop, your desktop, and a homelab box into one Command Center mosaic — next to Claude Code and Codex if you run those too.
Glueprint surface
Assistants on Gemini
Promote Gemini to a persistent assistant: persona, constitution, long-term memory, and a daily journal on disk, loaded into every wake.
Glueprint surface
Routines on a schedule
Wake Gemini on cron: triage the inbox every 30 minutes, sweep PRs at 9am, run the nightly cleanup. Quiet hours and watermarks prevent re-fires.
Glueprint surface
Analytics per harness
Messages, sessions, and output tokens computed from session logs — compare Gemini against Claude Code, Codex, and your other ACP agents.
Glueprint surface
Encrypted to the relay
Remote viewing rides AES-256-GCM envelope encryption. The relay routes; it cannot read.
AG-406A few useful answersNotes
Before youstart building.
Q.01Does Glueprint replace the Gemini CLI?
No. Glueprint is an Agentic Development Environment that hosts Gemini CLI. It spawns the official CLI you already installed and adds the surfaces around it: live session streaming, inline approvals, parallel worktrees, scheduling, memory, and remote control.
Q.02Do I need an API key or a separate Gemini subscription?
No. Glueprint doesn't resell model access. Sessions run through the gemini CLI's own authentication — your existing Google login, Gemini subscription, or API key is exactly what gets used.
Q.03What does "over ACP" mean here?
Gemini CLI ships native support for the Agent Client Protocol — an open standard for editor-to-agent communication. Glueprint speaks the protocol's client side, so Gemini connects the way Google built it to, while still getting first-class detection and its own capability profile.
Q.04Can I run Gemini from my phone?
Sessions always run on your machines — a laptop, a desktop, or a server with the headless daemon. The iOS and Android app streams them live, lets you send follow-ups, and handles permission approvals from anywhere.
Q.05Can I run Gemini next to Claude Code and Codex?
Yes — that's the point. Each harness is an adapter; sessions from all of them tile into the same Command Center, share the same task boards, and roll up in the same per-harness analytics.
Q.06Is my session content private?
Yes. Remote viewing routes AES-256-GCM-encrypted envelopes through the relay, which stores a wrapped key it cannot open — decryption happens on your devices. On the free local tier, session content never leaves your machine at all. See security.
AG-407Go to the sourceOfficial resources
Officialresources.
Gemini CLI · First-class ACP descriptor; capabilities are validated on the execution host.
AG-408Keep exploringThe same workspace
More agents.The same workspace.
AG-409 The local tier is free
Your next project.A place to begin.
Download once, run on your hardware, scale up to teams when you're ready. No credit card.