Windsurf

Vendor: Devin Desktop (formerly Codeium Windsurf) Install name: windsurf Status: GA Native config: <project>/.devin/rules/apothem-rules.md

Windsurf is now Devin Desktop, and .devin/rules/ is the preferred workspace-rules location (it takes precedence over .windsurf/rules/).

Installation

apothem install --harness windsurf --project /path/to/project

The adapter writes one project-scope Windsurf rules file from the shared Apothem rules and governance surface.

Files written: <project>/.devin/rules/apothem-rules.md

Profile-to-native-config mapping

The adapter reads Apothem's shared profile and renders the project rules file on every apothem install or apothem update run. The shared profile is the source of truth; project-local edits to the generated file are backed up before the next sync replaces the Apothem-managed content.

Compatibility notes

Windsurf's current rules surface is project-scoped under .devin/rules/ (the preferred location, which takes precedence over the .windsurf/rules/ backward-compat fallback). Workflows and machine-local memories are operator-owned; Apothem does not write them. The single-file .windsurfrules form is intentionally not written.

Verification

apothem verify --harness windsurf --project /path/to/project

The verify command confirms that:

1. The native config exists at the expected path.
2. All mandatory fields from the shared profile are present.
3. The adapter-specific verification routine reports success.

Updating

apothem update --harness windsurf --project /path/to/project

Re-derives the project rules file from the current shared profile state.

Uninstalling

apothem uninstall --harness windsurf --project /path/to/project

Removes the native config files written by the adapter. The shared profile YAML and Apothem engine are unaffected.

Conformity gate

python -m apothem.conformity.gate --all .

Troubleshooting

Configuration knobs

See also

• All harnesses — the full catalog of supported tools
• Install guide — install Apothem into this harness
• apothem harnesses reference — list and inspect adapters from the CLI