---
name: "windsurf-terminal-ai"
description: |
  Execute leverage AI-assisted terminal commands and debugging. Activate when users mention
  "terminal help", "command suggestion", "debug terminal", "shell assistance",
  or "cli help". Handles AI-enhanced terminal operations. Use when working with windsurf terminal ai functionality. Trigger with phrases like "windsurf terminal ai", "windsurf ai", "windsurf".
allowed-tools: "Read,Bash(cmd:*),Grep"
version: 1.0.0
license: MIT
author: "Jeremy Longshore <jeremy@intentsolutions.io>"
---

# Windsurf Terminal Ai

## Overview

This skill enables AI-assisted terminal operations within Windsurf. Cascade can suggest commands, explain error messages, generate complex shell scripts, and help debug terminal output. It understands common CLI tools, build systems, and DevOps commands to provide contextually relevant assistance for command-line workflows.

## Prerequisites

- Windsurf IDE with integrated terminal
- Shell environment configured (bash, zsh, etc.)
- Understanding of command-line basics
- Project-specific CLI tools installed
- PATH configured for required tools

## Instructions

1. **Enable AI Assistance**
2. **Configure Command Library**
3. **Set Up Error Handling**
4. **Optimize Workflows**
5. **Build Team Knowledge**


See `{baseDir}/references/implementation.md` for detailed implementation guide.

## Output

- Command suggestions and completions
- Error analysis and fixes
- Optimized command aliases
- Reusable shell scripts

## Error Handling

See `{baseDir}/references/errors.md` for comprehensive error handling.

## Examples

See `{baseDir}/references/examples.md` for detailed examples.

## Resources

- [Windsurf Terminal Guide](https://docs.windsurf.ai/features/terminal)
- [AI Command Assistance](https://docs.windsurf.ai/cascade/terminal)
- [Shell Scripting Best Practices](https://docs.windsurf.ai/guides/shell-scripts)