Module paths 

Cross-platform resolution of the per-user directories that AI harnesses use.

Most harnesses on macOS/Linux store config under $HOME/.<name> (dotdir convention) rather than the XDG config dir. On Windows, explicit %USERPROFILE%/%APPDATA% overrides are honored before falling back to shell-known folders, which is what those harnesses ship with too.

Functions

antigravity_cli_home

~/.gemini/antigravity-cli — Antigravity CLI’s global config directory.

antigravity_cli_mcp_global_file

~/.gemini/antigravity-cli/mcp_config.json — Antigravity CLI’s global MCP config.

antigravity_mcp_global_file

~/.gemini/antigravity/mcp_config.json — Antigravity’s global MCP config.

claude_home

~/.claude (all platforms).

claude_mcp_user_file

~/.claude.json — Claude Code’s user/local MCP config file.

cline_mcp_global_file

Cline’s global MCP settings file inside VS Code globalStorage.

codex_home

$CODEX_HOME if set, else ~/.codex.

config_dir

Returns $XDG_CONFIG_HOME (or its platform default) — used by OpenCode.

crush_home

Charm Crush’s per-user config directory.

cursor_home

~/.cursor (all platforms).

cursor_mcp_user_file

~/.cursor/mcp.json — Cursor’s MCP user-config file.

gemini_home

~/.gemini (all platforms).

hermes_home

~/.hermes (all platforms).

home_dir

Returns the user’s home directory or a AgentConfigError::PathResolution if the platform doesn’t expose one.

kilo_config_file

~/.config/kilo/kilo.jsonc — Kilo Code’s global JSONC config.

legacy_cline_mcp_global_file

Cline’s legacy global MCP settings file inside VS Code globalStorage.

openclaw_home

~/.openclaw (all platforms).

opencode_config_file

~/.config/opencode/opencode.json — OpenCode’s main config, where the object-based mcp map lives.

opencode_plugins_dir

OpenCode forces its plugin directory under ~/.config/opencode/plugins regardless of platform conventions. Returns that path.

pi_home

Pi coding-agent’s per-user config directory: ~/.pi/agent.

roo_mcp_global_file

Roo Code’s global MCP settings file inside VS Code globalStorage.

vscode_global_storage

VS Code globalStorage directory for an extension in the stable Code profile. extension_id is appended verbatim and is not validated; pass the publisher.name string used in the VS Code marketplace (e.g. "saoudrizwan.claude-dev").

windsurf_mcp_global_file

~/.codeium/windsurf/mcp_config.json — Windsurf’s global MCP config.