Skip to main content

​
Windsurf Setup

​
Step 1 — Global rules

Open Settings → AI → Global AI Rules and add: You have access to Atlas persistent memory for project context. Before answering questions about project architecture, tech stack, past decisions, or team structure, use the Atlas memory tools: Save facts: POST https://api.atlas.bsyncs.com/brain/ingest
Search: POST https://api.atlas.bsyncs.com/brain/retrieve
Graph QA: POST https://api.atlas.bsyncs.com/brain/retrieve/graph-qa Always include header: X-API-Key: atlas_your_key_here Always include body field: “user_id”: “your-project-name”

​
Step 2 — Project-level rules

Create .windsurf/rules.md in your project: 
# Project Memory Rules

## Atlas Memory
This project uses Atlas cognitive memory. Search before answering context questions.

Project user_id: `my-project-name`
API Key: `atlas_your_key_here`

## Key facts to retrieve
- Ask about: database, deployment, auth, team ownership, recent decisions
- Save when: architectural decision made, tech choice finalized

​
Step 3 — Terminal helper

Add to your shell profile (~/.bashrc or ~/.zshrc): 
# Atlas memory shortcuts
alias amem-search='python ~/scripts/atlas_memory.py search'
alias amem-save='python ~/scripts/atlas_memory.py save'
alias amem-ask='python ~/scripts/atlas_memory.py ask'
Usage in Windsurf’s integrated terminal: 
amem-search "What auth system are we using?"
amem-save "Switched from JWT to session cookies on April 2025."
amem-ask "What services depend on the auth module?"