Windsurf

Artificial intelligence for coding.

Table of Contents

Configuration Files

Rules

Windows base path is “C:\Users\%USERNAME%\.codeium\windsurf”.

ScopeOSPath
Global~/.codeium/windsurf/memories/global_rules.md
Workspace.windsurf/rules/*.md
AgentsAGENTS.md in any directory in your workspace
System (Enterprise)MacOS/Library/Application Support/Windsurf/rules/*.md
System (Enterprise)Linux/WSL/etc/windsurf/rules/*.md
System (Enterprise)WindowsC:\ProgramData\Windsurf\rules\*.md

Rules are located at

C:\Users\%USERNAME%\.codeium\windsurf\memories\global_rules.md

MCP servers:

C:\Users\%USERNAME%\.codeium\windsurf\mcp_config.json

Logs

By default, the main log directory is

C:\Users\%USERNAME%\AppData\Roaming\Windsurf\logs

Per-session log files:

  • main.log — App lifecycle, updates, errors
  • renderer.log — Extension host, UI rendering
  • ptyhost.log — Terminal/PTY sessions
  • terminal.log — Terminal interactions
  • telemetry.log — Telemetry events
  • window1/exthost/ — Extension host sub-logs

Reference