MyJackfruit

Help
Browse topics · Development

Development

← Development

My AI says it cannot reach my vault. What now?

Short answer

Type the check line in Claude Code, then do what its answer says: press Bind AI, or grant the AI vault read and write.

Before you start

You need Claude Code or Codex on your computer, the short name you gave this AI when you connected your computer, and GilbApp open on a computer, with Control on the vault. The pictures show a made-up person on a test site; your screen shows your own name and address.

Words used here (5)
AI vault
An AI vault is a small vault that stands for your AI; your AI reaches only the vaults you grant it.
short name
A short name is the one word you give one AI on one computer, such as gilb-example; it keeps that AI's key and tools apart.
GilbApp
GilbApp is the app, opened in a web browser at https://gilb.com/app, where you open, fill and share your vaults.
GilbPlatform
GilbPlatform is the service that keeps people's and organisations' data in vaults, each at its own web address.
Client ID
A Client ID is your AI's fixed name on GilbPlatform; find it by pasting GilbApp's line in a new Terminal window, then bind the AI.
Steps
  1. Type the check line in Claude Code and press Return.

    In Claude Code, type this line with your own short name in place of <short name>, and press Return:
    use gilb-<short name>: list the vaults you can reach

    More about this

    If Claude Code is not running, type claude in Terminal and press Return first. If Claude Code asks whether it may use a GilbPlatform tool, choose Yes; this only reads, and nothing in your vaults changes. If the answer names the vault you want, your AI can reach it: tell it to work there with use gilb-<short name>: work in <the vault's name>. If Claude Code says it has no such tool, the short name is not the one you used when you connected your computer.

  2. If it says the AI is not bound, paste its Client ID and press Bind AI.

    In GilbApp, open the AI vault's own pane, open ▸ CONNECT AI, paste the Client ID in the box Client ID and press Bind AI. The answer in Claude Code starts This AI is not bound to an AI vault yet. and shows the Client ID, the fixed name GilbPlatform gives your AI, on its own line.

    The vault's pane with "▾ CONNECT AI" open, a Client ID pasted in the box "Client ID", and the button "Bind AI" outlined in orange.
    The vault's pane with "▾ CONNECT AI" open, a Client ID pasted in the box "Client ID", and the button "Bind AI" outlined in orange.
    Show as text

    In the grey pane on the right, which shows your AI vault, "▾ CONNECT AI" is open with its numbered steps. Under step 5, "Find and copy the Client ID in your Claude chat, paste it here, then press Bind AI.", the box "Client ID" holds the pasted id. Just under it, the button "Bind AI" is outlined in orange: press it.

    More about this

    To open the AI vault's pane: press Main menu, the button at the top left, next to your profile picture, that shows the name of the section you are in; choose Vaults, find the AI vault's card and press its panel button at the top right. Scroll to ▸ CONNECT AI; its tabs macOS, Linux and Windows and the steps above Client ID are not needed now. The screen then says This client now acts as this vault. No AI vault yet? Make it first. From any other vault, Bind AI says This is a person's vault. If it says this client already acts as, this AI is bound to another AI vault: an AI is bound once.

  3. If it says the AI has no Read or Write, grant the AI vault read and write.

    In GilbApp, press Main menu, choose Vaults, press the panel button at the top right of the card of the vault the AI should reach, scroll down and open ▸ GRANT ACCESS. Choose Vault, paste the AI vault's address in the box, choose read, leave ONWARD REACH on Stops here, and press Grant; then do the same with write. The answer in Claude Code starts This AI acts as your AI vault's address and says it has no Read or Write on any vault, or on the vault you named, yet.

    The open "▸ GRANT ACCESS" section with "Vault" chosen, an AI vault's address in the box and "read" chosen, and the button "Grant" outlined in orange.
    The open "▸ GRANT ACCESS" section with "Vault" chosen, an AI vault's address in the box and "read" chosen, and the button "Grant" outlined in orange.
    Show as text

    In the right pane, "▾ GRANT ACCESS" is open. Under "SHARE WITH", "Vault" is chosen and the box holds the AI vault's address. Under "ACCESS", "read" is dark, which means chosen. The wide button "Grant" at the foot of the section is outlined in orange: press it, then do the same with "write". "ONWARD REACH" shows "Stops here" chosen, as it is when the section opens.

    More about this

    Use Vault, not Person: your AI acts as its AI vault. Typing the AI vault's name does not find it; paste its address, which its own pane shows under VAULT ID. Ignore PUBLIC at the top of the section. Stops here lets the AI reach this vault and no further; you do not need the other choice, Passes up hierarchy. The screen says Vault granted · read · stops here and then Vault granted · write · stops here. Your AI sees the access on its next call. See: How do I give my AI access to a vault?

  4. If it says GilbPlatform is out of reach, type the check line again in a minute.

    Wait a minute, then type the check line again. The answer reads GilbPlatform is restarting or out of reach just now, with a reason in brackets, and Try again in a minute.

    More about this

    It means GilbPlatform or your internet connection is down for a moment, not that anything is wrong with your AI or your vault. If it stays that way, write to [email protected].

Deeper

Your AI reaches its own AI vault, a small vault that stands for your AI, any vault it makes there, and the vaults you give its AI vault access to; with no grant it reaches none of your vaults.

The first time Bind AI works, the box This AI may create vaults shows, ticked: your AI may then make new vaults from Claude Code, each inside its AI vault. Untick it to stop that.

Three other answers can come. This AI could not sign in to GilbPlatform. and This computer could not sign in to GilbPlatform. say the sign-in failed and give no reason a page explains yet: type the check line again, and if it stays, write to [email protected]. This computer is not connected to GilbPlatform yet. goes on to name a command, gilb-computer add, that no GilbApp screen or help says where to get; connect your computer with ▸ CONNECT AI. See: How do I connect my computer to my vault?

If the answer names a vault you never granted to the AI, report it to [email protected].

The chat in GilbApp is not the same as your AI in Claude Code: the agent you chat with in GilbApp is not your AI vault: it works as you, with your own access, so it needs no grant. If the chat cannot reach your AI, see the answer on connecting your AI to GilbApp chat.

With Codex, OpenAI's AI for writing code, the line in step 1 is for Claude Code. In Codex, paste the line under Start Codex and get its Client ID. in ▸ CONNECT AI, with Codex chosen; with no short name typed it reads:
call the GilbPlatform tool gilbplatform_whoami and show me its full answer
Its answer says state: not bound until you bind the AI, then state: bound; then do step 2 or step 3 as above. After Bind AI, type /quit in Codex and start it again with codex: Codex reads the GilbPlatform tools only when it starts. To work in a vault, type use the GilbPlatform vault <the vault's name> in Codex; when Codex asks to allow gilbplatform_use_vault, choose Yes for this time, not always. See: How do I make an AI vault and connect Codex to it?

This answer is for a Mac.

Source: GilbApp 96968de7c3e3e685296f20a2599cbc8d305c9ea7 (live at https://gilb.com/app/version.json, read 12 November 2026): src/components/VaultAccessManager.tsx:279 (vault address refusal), :293 (Vault granted · …), :384 (This client now acts as this vault.), :609-679 (Vault, search box, read, write), :753 (Grant), :776-781 (▸ Connect AI, drawn in capitals), :918-925 (Client ID, Bind AI), :951-956 (work in <the vault's name>). The connector GilbApp ships, vendor/gilbplatformcode-gilb-connector/kaigilb-gilbplatformcode-gilb-connector-0.5.15.tgz, file connector/gilb-connector.mjs:32 (This computer is not connected to GilbPlatform yet. Run: gilb-computer add …), :34-41 (This AI is not bound to an AI vault yet., Client ID on its own line), :59-64 (This AI acts as … It has no Read or Write on … yet.), :159 (This AI could not sign in to GilbPlatform.), :170-173 (GilbPlatform is restarting or out of reach just now (…). Try again in a minute.). GilbPlatform 670005ccd64c229c59f905a00430d906781eb942 (live at https://id.gilb.com/version, read 12 November 2026): src/auth/bind-agent-vault.ts:145-150 (this client already acts as). Shared sentences word for word with the live answers How do I check that my AI can reach my vault?, How do I give my AI access to a vault?, How do I make an AI vault and connect Claude Code to it?, How do I connect my computer to my vault? and What is an AI vault?. Codex (added 13 November 2026): GilbApp 4557cf80 (https://gilb.com/app/version.json, read 13 November 2026), src/components/VaultAccessManager.tsx:105 (Claude Code on Windows is not available yet. Choose Codex.), :109 ("Choose Sign in with ChatGPT. Hand-offs run only on your ChatGPT sign-in, never on an API key."), :180-183 and :1014-1015 (Claude Code and Codex under the computer tabs), :581-657 (the Codex steps); src/lib/base/gilbConnector.ts:44-79. OpenAI, read 13 November 2026: https://learn.chatgpt.com/docs/pricing ("ChatGPT Work and Codex are included in your ChatGPT Free, Go, Plus, Pro, Business, Edu, or Enterprise plan"), https://github.com/openai/codex (npm install -g @openai/codex; Sign in with ChatGPT). Live answer: How do I make an AI vault and connect Codex to it?

Checked against GilbApp d529620.