Which agents does the .agents folder cover?

Any client that discovers Agent Skills under .agents/skills/ — including GitHub Copilot and other tools adopting that layout. Pair with AGENTS.md for agents that only read a root instructions file.

Where do Codex, Windsurf, and Gemini CLI fit?

They use the same skills/AGENTS.md outputs. For live tools, add the universal MCP server config to ~/.codex/mcp.json, Windsurf’s mcp_config.json, or Gemini’s settings.json respectively — see /agents for exact paths.

Do I need a page per IDE?

No. Dedicated pages exist for high-intent searches (Cursor, Claude Code, Copilot). This page is the catch-all for the open skill + AGENTS.md path every other agent shares.

[ integrations / agent-skills ]

One skill tree. Many agents.

You don’t need a separate integration for every IDE. By default Codehabits writes AGENTS.md and .agents/skills/codehabits-team-intel/ — the open layout agents already discover — plus .claude/skills for Claude-native clients. Codex, Windsurf, Gemini CLI, Copilot, and anything else that follows those conventions gets the same team intelligence.

How it works

01
Write portable agent files
enable defaults to agents-md, claude-skills, and agents-skills. Same conventions, three discovery paths so tools find them where they look.
02
Passive context first
Agents that read AGENTS.md or load Agent Skills pick up team conventions without MCP. No per-vendor stub files required.
03
Optional MCP everywhere
Drop the universal @codehabits/mcp config into the tool’s MCP settings when you want live get_team_context, check_code, and get_repo_map.

Setup

Step 1

Enable with default emit targets

Writes AGENTS.md, .claude/skills/, and .agents/skills/ (override with --targets or emit_targets in config).

npx @codehabits/cli enable

Step 2

Confirm skills are on disk

Commit .agents/skills/codehabits-team-intel/, .claude/skills/codehabits-team-intel/, and AGENTS.md so the whole team shares them.

Step 3

Optional: wire MCP (same config, different path)

Universal MCP snippet — place it in your agent’s MCP config file.

{"mcpServers":{"codehabits":{"command":"npx","args":["-y","@codehabits/mcp"]}}}

What you get

AGENTS.md Team Intelligence section (universal entry)
.agents/skills/codehabits-team-intel/ (cross-client Agent Skills)
.claude/skills/codehabits-team-intel/ (Claude Code + clients that scan it)
Optional @codehabits/mcp for Codex, Windsurf, Gemini CLI, Cursor, Claude Code

MCP config paths

Same universal server config — only the file location changes. Full copy-paste setup lives on the Agents page.

Agent	Config path	Notes
Codex CLI	~/.codex/mcp.json	Restart Codex after editing.
Windsurf	~/.codeium/windsurf/mcp_config.json	Reload settings or restart.
Gemini CLI	~/.gemini/settings.json	Under the mcpServers key.
Cursor	.cursor/mcp.json	Or npx @codehabits/cli mcp-install
Claude Code	claude mcp add …	Built-in MCP CLI

Docs & guides

FAQ

Which agents does the .agents folder cover?: Any client that discovers Agent Skills under .agents/skills/ — including GitHub Copilot and other tools adopting that layout. Pair with AGENTS.md for agents that only read a root instructions file.
Where do Codex, Windsurf, and Gemini CLI fit?: They use the same skills/AGENTS.md outputs. For live tools, add the universal MCP server config to ~/.codex/mcp.json, Windsurf’s mcp_config.json, or Gemini’s settings.json respectively — see /agents for exact paths.
Do I need a page per IDE?: No. Dedicated pages exist for high-intent searches (Cursor, Claude Code, Copilot). This page is the catch-all for the open skill + AGENTS.md path every other agent shares.