Intro to Command

Introduction to Command, our powerful inline code generation modality

Using Command: Inline AI Assistance

Command is a core Windsurf feature that generates new code or edits existing code directly within your editor using natural language prompts. It's designed for quick, file-scoped inline changes, helping you stay in your flow state.

  • Scope: Best for changes within the current file. Not intended for tasks requiring full repository context awareness.
  • Models: Uses its own set of models optimized for speed and accuracy in current-file edits.

How to Use Command in Your Editor:

  1. 1. Invoke: Press Cmd+I (Mac) or Ctrl+I (Windows/Linux) to open the Command prompt.
  2. 2. Prompt: Describe what you want in natural language.
    • Example: "validate the contact form email endswith.google.com"
  3. 3. Review & Act: Command shows a diff of proposed changes. You can:
    • Accept: Apply the changes.
    • Reject: Discard the changes.
    • Follow-up: Provide further instructions.
      • Follow-up Example: "add.yahoo.com as an option too" (after the initial email validation prompt).

Modes of Operation:

  • Generate Mode: If no code is highlighted, place your cursor where you want new code. Command will generate it at that location.
  • Edit Mode: Select (highlight) a section of code before invoking Command. The AI will then edit the selected lines.

Using Command in Your Terminal:

You can also use Command within Windsurf's integrated terminal to generate CLI commands from natural language.

  1. 1. Invoke: Press Cmd+I (Mac) or Ctrl+I (Windows/Linux) in the terminal.
  2. 2. Prompt: Describe the terminal command you need.
    • Example: "remove all the changes and untracked files" (Command might suggest git reset --hard && git clean -fd).
  3. 3. Review & Act: Accept, reject, or follow-up on the suggested command.

Key Highlights:

  • Ideal for fast, file-scoped inline code generation and edits.
  • Understands the context of your current file.
  • Supports follow-up prompts for iterative refinement.
  • Available in the terminal for generating CLI commands.

Command is excellent for making targeted changes efficiently without breaking your coding rhythm.

  • Select code before invoking Command to edit existing code
  • Try simple prompts first - Windsurf's context awareness often fills in the gaps
  • Use Command for file-scoped changes; use Cascade for multi-file operations

Command is ideal for quick code modifications without breaking your development flow.