Back to GigaRAG

Connect an agent

Give an AI tool access to your GigaRAG Workspace, so it can search, read and write your memos while it works.

Codex CLI

OpenAI's terminal agent. Its config is shared with the ChatGPT desktop app and the Codex IDE extension, so setting it up once covers all three.

Connect with the GigaRAG CLI

One command connects Codex CLI and every other AI tool on this machine. Signing in happens in your browser, so no key is written into any config file.

npm install -g gigarag
gigarag login
gigarag connect

Restart Codex CLI afterwards. Nothing here expires, and gigarag connect --remove takes GigaRAG back out of everything it touched.

Sign in with GigaRAG

Connect without a key: Codex CLI opens your browser, you sign in to GigaRAG and pick this workspace.

  1. 1.

    Add GigaRAG without a key

    codex mcp add gigarag --url https://mcp.gigarag.com/mcp
  2. 2.

    Start the sign-in

    codex mcp login gigarag
  3. 3.

    Sign in with your GigaRAG account

    Your browser opens GigaRAG. Pick the workspace to share and approve. No key is stored in the app, and the connection does not expire.

Or paste a prompt

Paste this into Codex CLI. It carries your agent key and tells the agent exactly what to change, so it sets the connection up itself.

Merge into ~/.codex/config.toml:

[mcp_servers.gigarag]
url = "https://mcp.gigarag.com/mcp"
http_headers = { "Authorization" = "Bearer <api-key>" }

Then tell me to restart Codex. Don't repeat the key.

Or set it up by hand

  1. 1.

    Add this to your Codex config

    On Windows the file is %USERPROFILE%\.codex\config.toml. Create it if it does not exist, and keep anything already in it.

    ~/.codex/config.toml
    [mcp_servers.gigarag]
url = "https://mcp.gigarag.com/mcp"
http_headers = { "Authorization" = "Bearer <api-key>" }
  2. 2.

    Restart Codex

    Run /mcp to see gigarag listed.

Check it worked

Send this once it is connected. An answer drawn from your workspace means the connection is live.

List my GigaRAG buckets.

Written from the official docs: Codex MCP