FAQ — Glueprint Docs

General

Does Glueprint ship its own AI model?

No. Glueprint runs coding agents you install yourself: Claude Code, Codex, or Gemini CLI. Each agent reads its own API credentials and bills its own usage.

Do I need an internet connection?

For local use on one machine: no. The desktop app works offline. Sessions, assistants, memory, git, the editor, and terminals all run without an internet connection.

For multi-machine sync, portal access, mobile, or anything that goes through the cloud relay: yes.

How is Glueprint different from running Claude Code directly?

Glueprint adds persistent assistants, memory, scheduled routines, multi-host coordination, teams, governance, mobile and portal surfaces, and an integrated workspace with editor, git, terminal, and tasks. You can think of it as a multi-agent IDE built on top of the coding agents you already use.

Can I use my own AI model?

We support Claude Code, Codex, and Gemini CLI. If you have a third-party agent that follows a similar protocol, file a feature request and we’ll consider it.

Plans and billing

What’s the difference between a host and a seat?

A host is one machine. A seat is one human user. You pay for them separately. See Plans and Seats, hosts, and teams.

What happens to my data if I cancel?

It stays on disk on each host. Cloud relay disconnects at the end of the cycle. If you re-subscribe later, everything’s still there.

Can I get a refund?

Case by case. Contact support.

Privacy and security

Does Glueprint read my code?

The desktop app runs on your machine and the agents read your code from your filesystem — that’s how coding agents work. Beyond that, no Glueprint employee reads your code.

What does the cloud relay see?

Routing metadata: which host is talking to which surface, sequence numbers, sizes, timestamps. Not content: every transcript, chat, and tool call is encrypted with keys we never have. See Cloud Relay & Encryption.

Can I use Glueprint without the relay?

Yes. Free supports local Desktop work, remote host and session status, and actionable decision alerts. You can approve or deny a permission prompt and answer a question, without transcripts, streaming output, general session control, git, files, terminals, or port forwarding. Lite adds full live mobile sessions; Pro or higher adds full live web portal sessions.

Do you sell my data?

No. We don’t sell, share, or monetize your data.

Multi-machine

Can I use the same activation key on two machines?

No. Each machine needs its own host registration. On a new desktop, sign in and choose an eligible pending host or create one if you are an owner or admin with capacity. The alternative key path still requires a separate, appropriate key for each machine.

My laptop and desktop are both running Glueprint — do they see each other?

Yes, through the portal, if you’re on Pro or higher. Both show up as hosts; switch between them in any surface.

Sessions started on one machine stay on that machine; they don’t migrate. But you can see them all from anywhere.

Can an assistant on machine A talk to an assistant on machine B?

Yes. Add assistants from different hosts to the same channel and they work together there; see Assistants in channels. Cross-host work requires Pro or higher.

Assistants

How is an assistant different from a session?

A session is one running conversation. An assistant is a persistent teammate that has memory, a direct message with you, tasks, routines, and many sessions over time. See AI Assistants.

If you both have access to the same host (via your account’s user list), you both see the assistant. Mobile and portal surfaces and the assistant’s tasks are shared. Each of you has your own direct message with it, and you can both talk to it in any channel it is a member of. See Seats, hosts, and teams.

How much memory does an assistant store?

Soft cap: 40 KB for long-term entries (you’ll see a warning). Hard cap: 150 KB. Reference files and journal don’t count toward the cap. See Memory.

Troubleshooting

The app froze. What do I do?

Force-quit and relaunch. Sessions are persistent on disk; you won’t lose state.

How do I report a bug?

In the desktop app, click the Help (?) button at the bottom of the left rail and choose Report a bug. In the web portal, open Help in the sidebar footer and choose Report a bug. Describe what happened. Optional questions follow: the steps to reproduce it, what you expected, how often it happens and how much it affects you. Every answer you add helps us find and fix the bug faster. Attach screenshots or a screen recording: drag files onto the form, paste an image, or click Attach. The form pre-fills a System details box with your Glueprint version, operating system and shell, and the desktop app can add a diagnostics report with paths, user names and host names removed. You can edit or delete those details before you send. Use Request a feature from the same menu for ideas; it asks what problem the feature would solve and how you handle it today. An agent working in a Glueprint session can also file the report for you with the gp_submit_feedback tool; you see the whole report and approve it before anything is sent.

You can also email support@glueprint.ai.

I lost my password and don’t have recovery codes.

Contact support. We can verify your identity and reset the password, but content encrypted under the old password isn’t recoverable. Set up recovery codes when you can; see Recovery codes.