# Install Archipelago Agent memory for human brains: your agent's plans and decisions as a map you read, correct, share. It is at https://app.archipelago.tools. Connecting an agent takes one step and one sign-in in the browser; there is nothing to host. ## For a person Paste one line in a terminal. It finds Claude Code, Codex and Cursor on this computer, connects each, and opens your browser once to sign in. Windows (PowerShell): irm https://app.archipelago.tools/connect/install.ps1 | iex macOS or Linux: curl -fsSL https://app.archipelago.tools/connect/install.sh | sh Or ask your agent: "Install Archipelago from https://app.archipelago.tools/connect/install". ## For an agent asked to install Archipelago Connect to this server: find your section below and follow it. Do not ask whether to host it, and do not set up a server of your own unless the person asked for one. Tell the person, in one line, what you are about to run and that a browser window will ask them to sign in, where someone with no account chooses Start a workspace; then run it. Every command here is safe to read first: the installer is at https://app.archipelago.tools/connect/install.mjs. For Claude Code, Codex or Cursor, run the installer with your shell tool, naming your client (`claude`, `codex` or `cursor`). On Windows, in PowerShell: & ([scriptblock]::Create((irm https://app.archipelago.tools/connect/install.ps1))) --client claude --yes On macOS or Linux: curl -fsSL https://app.archipelago.tools/connect/install.sh | sh -s -- --client claude --yes Add `--dry-run` to see what it would do, changing nothing. ### What it changes - **Writes** your client's connection (Claude Code's plugin; Codex's and Cursor's server entry and session hooks), and ~/.pelago: the sign-in, a token in a file only this user can read, and the hook scripts. - **Sends**, from the hooks to this server, as the session's record on the person's map: each session's start and end, its prompts, the tokens it used, the files it touched, and its folder's repository, branch and recent commits. ### Claude Code It installs the Archipelago plugin (`claude plugin install archipelago --marketplace AlexReiner98/archipelago`) and waits while the person says Allow in the browser. The plugin's tools load with the next session. Until then, reach the map from this one with: node ~/.pelago/bin/pelago-login.mjs call query name=frontier (any tool and its input as words: `call query name=brief task=`, `call report action=tell run= said=...`, each word but name and action one of its params; or the input as JSON). It ends by naming the map it reached: tell the person which. An older `pelago` server in ~/.mcp.json, which would sit beside the plugin's, is taken out (a copy kept as ~/.mcp.json.pelago-old): tell the person it was, and that `--keep-old` leaves it. ### Codex It runs `codex mcp add pelago --url https://app.archipelago.tools/mcp` and then `codex mcp login pelago`, which opens the browser, and writes the session hooks in ~/.codex/hooks.json. Tell the person to type `/hooks` in Codex once and allow the four Archipelago hooks. The tools load with the next session. ### Cursor It adds `"pelago": { "url": "https://app.archipelago.tools/mcp" }` to ~/.cursor/mcp.json and the session hooks to ~/.cursor/hooks.json, and opens the browser once for the hooks' sign-in. Tell the person to open Settings, MCP, and press Connect beside pelago to sign in. ### Grok Bot Adding a server is something you do in chat: add a custom MCP server called "pelago" at https://app.archipelago.tools/mcp. The person presses Add, then Authorize, and signs in. ### ChatGPT You cannot add it yourself. Tell the person: in ChatGPT, Settings, Apps, Advanced settings, turn on Developer mode; then Create app, name it Archipelago, give it the address https://app.archipelago.tools/mcp with OAuth, and sign in when asked. It needs a plan with Developer mode. ## Once connected At the start of each session, call `capture` with action `session_start` (the server's instructions say how), then work from the map: `query` reads, `change` writes, `report` tells. The person sees it all at https://app.archipelago.tools. ## Host it yourself Only for a person who asks to run their own server: it is open source, at https://github.com/AlexReiner98/archipelago. Everything above connects to this one.