Windsurf + LoopCLI

Windsurf is Codeium's new agentic IDE that brings AI flow mode to your development workflow. This guide shows how to connect LoopCLI so you can scaffold, run, and deploy automation loops directly from Windsurf's intelligent editor.

1. Install LoopCLI & expose it to Windsurf

1. Verify LoopCLI is installed (loopcli version).
2. Ensure the binary is discoverable by Windsurf:
   • macOS/Linux: add export PATH="$HOME/.local/bin:$PATH" (or wherever loopcli lives) to .zshrc / .bashrc.
   • Windows: add %USERPROFILE%\.loopcli to your PATH and restart Windsurf.
3. Open Windsurf's terminal (Ctrl+``) and confirm loopcli version` works.

2. Configure Windsurf tasks

Windsurf supports custom tasks that integrate with its AI flow mode. Add these to your .vscode/tasks.json (Windsurf uses VS Code task format):

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "LoopCLI: Run Active Loop",
      "type": "shell",
      "command": "loopcli loop run ${relativeFile}",
      "problemMatcher": []
    },
    {
      "label": "LoopCLI: Deploy Active Loop",
      "type": "shell",
      "command": "loopcli loop deploy ${relativeFileBasename} --activate",
      "problemMatcher": []
    }
  ]
}

Now Windsurf's AI can suggest and trigger these tasks as part of its flow mode.

3. Teach Windsurf AI about LoopCLI YAML

Windsurf's strength is its agentic AI capabilities. Feed it the LoopCLI schema so suggestions are accurate:

1. Create a .windsurf/rules.md or .codeium/rules.md file with:
   • Common LoopCLI YAML patterns (HTTP steps, CLI steps, schedules)
   • Examples of how loops pass data between steps
   • Secret management conventions
2. Reference the LoopCLI documentation in your workspace context
3. Use Windsurf's "Cascade" AI to walk through creating a loop the first time—it learns from the interaction

This context prevents the AI from hallucinating invalid configurations.

4. Terminal automation & secrets

• Windsurf's integrated terminal respects your shell environment, making loopcli commands seamless
• Use the AI command palette to run loopcli secret add or loopcli loop list without typing
• Keep secrets in the LoopCLI Vault—never commit .env files. When Windsurf's AI suggests environment variables, redirect it to use loopcli secret instead

5. AI flow mode with LoopCLI

Windsurf's flow mode can help you build complex automation workflows:

The AI learns LoopCLI patterns and suggests improvements as you work.

6. Troubleshooting

Next steps

• Combine Windsurf's AI with Starter Recipes for rapid automation
• Explore Connectors to integrate SaaS APIs into your loops
• Join Discord to share Windsurf + LoopCLI workflows with the community