Connect Local Coding Agents to Thegram for Mac

@gram 2
doc d_127b30e9a5c64e2aa472db36e7214a3d
t Connect Local Coding Agents to Thegram for Mac
d Meet current Mac and Node prerequisites, let the person enable Agent Access, then install a host plugin and verify read-only.
tag guides
tag local
view document
::body
# Connect local coding agents

The Thegram Mac app hosts a local MCP server. Claude Code, Codex, OpenCode and OMP connect on this Mac while the app is open. Local-only folders are not available to a Cloud connection.

## Prerequisites

- Apple silicon (arm64); macOS 26 or later; Node.js 22+ on PATH.
- Thegram installed and running. The app must remain open; its local MCP socket is ~/Library/Application Support/Thegram/mcp.sock.
- The person chooses Agent Access in Thegram → Settings… → Agent Connections. Read is sufficient for inspection. Never change this setting on the person’s behalf.

## Select a client and install

These exact command blocks come from the canonical local install source. Run only the block for the chosen host; the person handles install commands and host trust prompts.

Claude Code:

```sh
claude mcp remove --scope user thegram >/dev/null 2>&1 || true
claude plugin marketplace add clab-one/thegram-mcp || claude plugin marketplace update thegram-memory
claude plugin install thegram-memory@thegram-memory
claude plugin update thegram-memory@thegram-memory || true
```

Codex:

```sh
codex mcp remove thegram >/dev/null 2>&1 || true
codex plugin remove thegram@thegram-local >/dev/null 2>&1 || true
codex features enable hooks
codex plugin marketplace add clab-one/thegram-mcp || codex plugin marketplace upgrade
codex plugin add thegram-memory@thegram-memory
```

OpenCode:

```sh
opencode plugin add github:clab-one/thegram-mcp
```

OMP:

```sh
omp plugin marketplace add clab-one/thegram-mcp || true
omp plugin install thegram-memory@thegram-memory
omp plugin upgrade thegram-memory || true
```

## Verify without writing

1. Keep Thegram open and confirm Connection says Running in Agent Connections.
2. Call gram_capabilities, gram_projects and gram_brief for the exact returned path; call gram_read without section to get its outline, then gram_read with a returned heading as section. This is read-only.
3. Expected: the intended project is visible and the brief/read return current revision and content. No write is needed to verify connectivity.

## Troubleshooting

- Socket absent or unreachable: open Thegram, ask the person to review Agent Access, confirm Connection is Running, and check no second app copy holds the socket.
- Node missing or old: the person installs the current Node.js prerequisite from https://nodejs.org and opens a fresh Terminal.
- Plugin disconnected: follow the canonical guide’s host-specific doctor check and start a new session.
- Codex trust prompt or any account/permission prompt: the person decides; do not accept or change it on their behalf.

Exact host commands and caveats: https://thegram.one/install/agents.md
::end