Coding
PromptBeginner5 minmarkdown
Markdown Converter
Agent skill for markdown-converter
52
Agent: Windsurf (Codeium)
- **Directory**: `.windsurf/workflows/`
promptBeginner5 min to valuemarkdown
0 views
Feb 24, 2026
Loading actions...
- **Directory**: `.windsurf/workflows/`
Loading actions...
.windsurf/workflows/# Windsurf IDE (macOS)
brew install --cask windsurf
# or download from https://windsurf.com
# Shell integration
windsurf --locate-shell-integration-path zsh
which windsurf && windsurf --version
$ windsurf --version
Windsurf 1.106.0
$ which windsurf
/opt/homebrew/bin/windsurf
$ windsurf chat --help
Usage: windsurf chat [options] [prompt]
Options:
-m --mode <mode> The mode to use: 'ask', 'edit', 'agent'
-a --add-file <path> Add files as context
--maximize Maximize the chat session view
-r --reuse-window Force to use the last active window
-n --new-window Force to open an empty window
Status: CLI exists but requires GUI. The windsurf chat command opens the IDE with a chat session - it is NOT a headless CLI.
windsurf chat "Your prompt" (opens GUI)windsurf chat -a file.js "Review this"# Opens IDE with chat session (NOT headless)
windsurf chat "Write a hello world function"
# With specific mode
windsurf chat -m agent "Build this feature"
windsurf chat -m ask "Explain this code"
windsurf chat -m edit "Refactor main.js"
# With file context
windsurf chat -a src/main.js "Review this file"
-a, --add-file flagNot applicable for automation - Windsurf chat command opens GUI and does not return until the user closes the session.
| Code | Meaning |
|---|---|
| 0 | IDE launched successfully |
| Non-zero | Launch error |
Note: Exit code indicates launch success, not task completion.
# No CLI authentication method
# Must authenticate through IDE GUI
A community project provides Windsurf in a Docker container with virtual display:
# https://github.com/pfcoperez/windsurfinabox
docker run -e CODEIUM_TOKEN=<token> \
-v ./instructions:/workspace/windsurf-instructions.txt \
ghcr.io/pfcoperez/windsurfinabox
How it works:
windsurf-instructions.txt fileLimitations:
Codeium offers Termium for terminal autocomplete:
curl -L https://github.com/Exafunction/codeium/releases/download/termium-v0.2.0/install.sh | bash
Note: Termium is autocomplete only (like GitHub Copilot's old suggest command). It does NOT provide agentic task execution.
Direct API access may be possible but undocumented:
[ ] No - GUI-only, no native headless mode
High - No native headless support. Docker workaround (windsurfinabox) is the only option and is fragile.
Not recommended for autonomous orchestration due to lack of headless support.
If headless operation is required, consider alternatives:
# Workaround only (NOT RECOMMENDED for production)
# Using windsurfinabox Docker image
docker run \
-e CODEIUM_TOKEN=$CODEIUM_TOKEN \
-v $(pwd)/tasks/WP01-prompt.md:/workspace/windsurf-instructions.txt \
ghcr.io/pfcoperez/windsurfinabox
| Feature | Windsurf | Claude Code | Copilot CLI |
|---|---|---|---|
| Headless flag | ❌ None | -p, --print | -p, --prompt |
| File edits | GUI only | --allowedTools | --allow-all |
| JSON output | ❌ No | Yes | -s for clean output |
| Stdin support | ❌ No | Yes | Via shell |
| Session resume | GUI only | Yes | Yes |
| Orchestration ready | ❌ No | ✅ Yes | ✅ Yes |
| Feature | Termium | Windsurf chat |
|---|---|---|
| Type | Terminal autocomplete | Full IDE + AI |
| Headless | Partial (autocomplete) | No |
| Agentic | No | Yes (but GUI only) |
| Installation | Shell script | Application bundle |
windsurf --help, windsurf chat --help (v1.106.0)