Skip to main content

​
Windsurf Integration

Windsurf is an AI-native IDE by Codeium. Hubify integrates with Windsurf’s Cascade AI and Flows system to provide verified skill context.

​
Prerequisites

  • Windsurf IDE installed
  • Hubify CLI installed (npm install -g hubify)
  • Hubify initialized in your project (hubify init)

​
Setup

​
1. Initialize Hubify

cd your-project
hubify init --platform windsurf

​
2. Install Skills

hubify install typescript-strict-mode react-best-practices

​
3. Configure Cascade

Add Hubify context to Windsurf’s Cascade AI by creating .windsurf/cascade.md: 
# Hubify Skills Integration

This project uses Hubify for AI skill management.

## Commands
- `hubify search "<query>"` - Find skills
- `hubify info <skill> --prompt` - View instructions
- `hubify report <skill> --success/--failed` - Report results

## Installed Skills
- typescript-strict-mode: TypeScript configuration
- react-best-practices: React patterns

## Workflow
Before implementing features:
1. Search for relevant skills
2. Apply skill guidance
3. Report results

​
Using with Cascade

​
In Chat

@cascade Configure TypeScript strict mode for this project.

First, check the Hubify skill:
hubify info typescript-strict-mode --prompt

Then apply those guidelines.

​
Flows Integration

Create a Hubify flow in .windsurf/flows/: 
# .windsurf/flows/hubify-skill.yaml
name: Apply Hubify Skill
steps:
  - run: hubify search "{{task}}"
    output: skills
  - run: hubify info {{skills[0].name}} --prompt
    output: instructions
  - apply: instructions
  - run: hubify report {{skills[0].name}} --success

​
Workspace Configuration

​
Rules File

Create .windsurf/rules.md to document installed skills and team conventions.

​
Settings Integration

Add to Windsurf settings: 
{
  "cascade.context": {
    "includes": [
      ".windsurf/cascade.md",
      ".hubify/config.yaml"
    ]
  }
}

​
Reporting

hubify report typescript-strict-mode \
  --success \
  --verified \
  --platform windsurf \
  --output "Strict mode configured for all packages"

​
Troubleshooting

IssueSolution
Cascade can’t find skillsEnsure .windsurf/cascade.md exists and is readable
Skills outdatedRun hubify update
Integration issuesRun hubify doctor

​
Next Steps

CLI Reference

All CLI commands

Claude Code

Claude Code integration

Cursor

Cursor integration

SDK

Programmatic access