Connect your coding agent

Connect your coding agents through Configure to share approved user context. Each connected agent can access your profile, including tool preferences and information saved by other approved agents.

Setup requires an MCP connection and profile-use instructions. The MCP connection provides the configure_* tools. The instructions specify when the agent should read, search, and save context. Tools alone do not ensure consistent profile use.

Install

Configure the MCP connection and install the profile-use instructions. Keep personal instructions out of shared repositories, where they could apply to users who have not connected Configure.

The Cursor and Windsurf examples append instructions to AGENTS.md in the current directory. Run that step only in a private checkout. For a shared project, copy the contents of agents-block.md into your personal rules instead of running the append command.

Claude Code

# 1. Memory
claude mcp add --transport http configure https://mcp.configure.dev

# 2. Habit (installs the configure-memory skill and a session-start digest hook)
curl -fsSL https://docs.configure.dev/skill/install.mjs | node -

Codex

# 1. Memory
codex mcp add configure --url https://mcp.configure.dev
codex mcp login configure

# 2. Habit (idempotent: skips if already present)
mkdir -p ~/.codex && grep -qs "User memory (Configure)" ~/.codex/AGENTS.md \
  || curl -fsSL https://docs.configure.dev/skill/agents-block.md >> ~/.codex/AGENTS.md

Gemini CLI

# 1. Memory (add -s user for a global server)
gemini mcp add --transport http configure https://mcp.configure.dev

# 2. Habit (Gemini CLI reads GEMINI.md by default)
mkdir -p ~/.gemini && grep -qs "User memory (Configure)" ~/.gemini/GEMINI.md \
  || curl -fsSL https://docs.configure.dev/skill/agents-block.md >> ~/.gemini/GEMINI.md

Cursor

# 1. Memory: add to ~/.cursor/mcp.json (Settings -> MCP), then approve the OAuth popup
#    { "mcpServers": { "configure": { "url": "https://mcp.configure.dev" } } }

# 2. Habit (Cursor reads AGENTS.md natively)
grep -qs "User memory (Configure)" AGENTS.md \
  || curl -fsSL https://docs.configure.dev/skill/agents-block.md >> AGENTS.md

Windsurf

# 1. Memory: add to ~/.codeium/windsurf/mcp_config.json (Settings -> Cascade -> MCP)
#    { "mcpServers": { "configure": { "serverUrl": "https://mcp.configure.dev" } } }

# 2. Habit
grep -qs "User memory (Configure)" AGENTS.md \
  || curl -fsSL https://docs.configure.dev/skill/agents-block.md >> AGENTS.md

Approve the OAuth prompt the first time. The configure_* tools then appear in the agent's tool list. Repeat this for every agent you use. Each approved agent accesses the same user profile.

Verify it worked

Ask a question that requires information from your profile:

what test runner do I normally use?

A connected agent calls configure_profile_search and answers from the result. If the agent says it has no way to know, check whether the profile-use instructions are installed. Re-run the second command.

Share project context between agents

Connected agents can share project status, decisions, and handoff notes through an approved project. See Projects.