Installation

Set up ClaudeLink for Claude Code, Codex CLI, Gemini CLI, and Goose, globally or per project.

Requirements

Node.js 18 or newer.
One or more MCP-compatible clients: Claude Code, OpenAI Codex CLI, Google Gemini CLI, or Block's Goose.
macOS or Linux for the full hands-free loop. Messaging works on any platform with Node; on Windows, run inside WSL with tmux for auto-nudge.

Install the package

npm install -g claudelink

Add it to your client

Each CLI keeps its MCP config in its own file. The claudelink init command writes the right one for whichever flags you pass. The fastest path is all four at once, globally:

claudelink init --all --global

Or configure each client on its own:

Client	Command
Claude Code	`claude mcp add --scope user claudelink -- claudelink-server`
Codex CLI	`claudelink init --codex --global`
Gemini CLI	`claudelink init --gemini --global`
Goose	`claudelink init --goose --global`

Per-project setup

Drop the --global flag to configure only the current project. Flags stack, so you can mix and match:

cd your-project
npx claudelink init                  # Claude Code
npx claudelink init --codex          # Codex CLI
npx claudelink init --codex --gemini # both, stacked
npx claudelink init --all            # all four

Running init more than once is safe. If a config or instructions file already exists, ClaudeLink appends its block with a marker check, so there is no duplication and your existing content is preserved.

Restart your terminals

Each CLI reads its config on startup, sees ClaudeLink, and connects. The tools just appear. Next, see the Quickstart for a first run or Configuration for where each file lives.