Windsurf Free Tier Limits: What You Get (and When You'll Hit the Wall)
In this article
Windsurf's free tier gives you 25 Flow Actions per month, access to the SWE-1 mini model, and a 16K context window. It's enough to evaluate the tool, but not enough for daily development work. If you hit the cap mid-session, Windsurf stops generating until your monthly quota resets or you upgrade to a paid plan.
- 25 Flow Actions/month on the free tier (as of July 2026)
- Access to SWE-1 mini (not full SWE-1 or frontier models like GPT-4.1/Claude Sonnet)
- No team features, no priority access, no BYO API key on free
What are Windsurf Flow Actions?
Flow Actions are the unit Windsurf uses to meter agentic AI usage. Each time the AI reads a file, runs a command, edits code, or searches your codebase as part of a task, it counts as one or more Flow Actions. A single multi-step task (edit a file, run tests, fix an error) can consume 5-15 actions. At 25/month, that's roughly 2-5 substantial agentic tasks before you're blocked.
Simple autocomplete suggestions (tab completions) don't count toward Flow Actions on any plan. The cap applies specifically to agentic "Cascade" flows where Windsurf acts autonomously across your codebase.
Windsurf free tier: full breakdown
| Feature | Free | Pro ($15/mo) | Teams ($35/user/mo) |
|---|---|---|---|
| Flow Actions / month | 25 | 500 | Unlimited (fair use) |
| Model access | SWE-1 mini | SWE-1, GPT-4.1, Claude Sonnet | All models |
| Context window | 16K tokens | 128K tokens | 128K tokens |
| Autocomplete | Unlimited | Unlimited | Unlimited |
| BYO API key | No | Yes | Yes |
| Priority access | No | Yes | Yes |
Pricing and limits sourced from Windsurf's pricing page. Plans and limits change periodically, so check that page for the current state before committing.
When does the Windsurf free tier reset?
Free tier Flow Actions reset on a rolling monthly basis, tied to your account creation date, not a calendar month. So if you created your account on the 15th, your quota resets on the 15th of each month. You can check your remaining balance in the Windsurf dashboard under account settings.
What happens when you hit the limit?
When your 25 Flow Actions are exhausted, Windsurf's Cascade agent stops accepting new agentic tasks. Autocomplete still works. You'll see a usage exceeded message in the chat panel. Your options at that point are: wait for the monthly reset, upgrade to Pro, or use BYO API key mode (Pro feature) to route requests through your own OpenAI or Anthropic account.
How does Windsurf's free tier compare to other tools?
| Tool | Free Tier | What's included |
|---|---|---|
| Windsurf | 25 Flow Actions/mo | SWE-1 mini, autocomplete |
| Cursor | 2-week trial (Pro), then Hobby | 2,000 completions/mo, limited fast requests |
| Kiro | Free preview (limited) | Limited agentic tasks during preview period |
| GitHub Copilot | 2,000 completions + 50 chat/mo | GPT-4o mini for chat |
| Claude Code | Via Claude Pro ($20/mo) | Usage-based within 5-hour window |
If you're evaluating Windsurf against the competition, see the full breakdown in Cursor vs. Windsurf (2026) and Lovable vs. Windsurf.
Is the Windsurf free tier worth it?
25 actions per month is enough to run a real evaluation: pick one feature, build it end-to-end with Cascade, and see how much manual correction you need. It's not enough for production use. The free tier is a trial, not a sustainable plan. If Windsurf fits your workflow, the $15/month Pro plan is a reasonable step-up.
The constraint most developers hit first isn't the action count: it's the 16K context window on free. Larger codebases get truncated, which leads to Cascade making edits without seeing the full picture. Pro's 128K window is a significant upgrade for anything beyond toy projects.
How to track your Windsurf usage?
Windsurf shows your remaining Flow Actions in the account dashboard. There's no native notification before you run out. If you're using multiple AI coding tools simultaneously (e.g., Windsurf for agentic tasks, Claude Code for chat), consider using separate monitoring for each tool. For Claude Code specifically, Usagebar tracks your 5-hour usage window and weekly cap in the macOS menu bar, with alerts at 50/75/90%.
Key takeaways
- Windsurf free tier includes 25 Flow Actions/month, SWE-1 mini, and 16K context
- Actions reset monthly from your account creation date
- Autocomplete is unlimited on all plans including free
- The 16K context window is the practical bottleneck for real projects, not just the action count
- Pro ($15/mo) unlocks 500 actions, 128K context, frontier models, and BYO API key
- When you hit the cap, agentic tasks stop; autocomplete continues
Related
Never Get Locked Out Mid-Task Again
Never hit your usage limits unexpectedly. Usagebar lives in your menu bar and shows your 5-hour and weekly limits at a glance.
Get Usagebar$9 — one-time, lifetime updates