Setup HighFly Account

HighFly extension directly connects with the HighFly web app. Set up your account now at HighFly

HighFly VS Code Extension

A comprehensive VS Code extension that integrates with HighFly, a modern project management platform. This extension provides seamless authentication, issue management, and TODO tracking directly within your VS Code environment.

🚀 Features

Authentication & Organization Management

• Secure OAuth Authentication: Sign in to HighFly using Google OAuth with automatic token refresh
• Multi-Organization Support: Switch between different organizations and teams
• VS Code Integration: Native authentication provider that integrates with VS Code's Accounts menu

Issue Management

• Issues Sidebar: View and manage your team's issues directly in VS Code
• Issue Preview: Preview issue details in a dedicated sidebar panel
• Quick Actions: Create, open, and manage issues without leaving your editor
• Cursor AI Integration: Send issues directly to Cursor Chat (requires Cursor IDE Nov 2024+)

TODO Integration

• Smart TODO Detection: Automatically detect TODO comments in your code
• Visual Highlighting: Highlight TODO items with customizable decorations
• CodeLens Integration: Show TODO counts and actions directly in your code
• Hover Information: Get detailed information about TODOs on hover
• Quick Actions: Convert TODOs to HighFly issues with a single click
• Rich Code Context: Automatically captures surrounding code with syntax highlighting when creating issues from TODOs

📋 Available Commands

Access these commands through the Command Palette (Cmd+Shift+P or Ctrl+Shift+P):

Authentication Commands

• Highfly: Sign in - Sign in to your HighFly account
• Highfly: Sign out - Sign out of your HighFly account
• Highfly: Switch Organization - Switch between organizations
• Highfly: Switch Team - Switch between teams within an organization

Issue Management Commands

• Highfly: Toggle Features - Enable/disable extension TODO features

🔐 Getting Started

Prerequisites

• VS Code 1.95.0 or higher (also compatible with Cursor and Windsurf)
• Cursor IDE: Version from November 24, 2024 or later (required for "Send to Cursor" feature)
• A HighFly account (sign up at highfly.app)
• The HighFly backend running locally (for development)

Installation

1. Install the extension from the VS Code marketplace or load it from source
2. Sign in to HighFly:
   • Open Command Palette (Cmd+Shift+P or Ctrl+Shift+P)
   • Type "Highfly: Sign in" and select it
   • Complete the authentication flow in your browser
3. Access the Issues sidebar - Look for the HighFly icon in the Activity Bar

🎯 How to Use

Managing Issues

1. View Issues: Click the HighFly icon in the Activity Bar to see your issues
2. Filter Issues: Click the Filter option to filter between issues
3. Preview Issues: Click on any issue to preview its details. Press the eye icon to see it on the tab
4. Open in Browser: Click an issue and scroll until you see "Open in Browser"

Working with TODOs

1. Write TODOs: Add TODO comments in your code (e.g., // TODO: Fix this bug)
2. View TODOs: TODOs are automatically highlighted and counted in the status bar
3. Create Issues: Hover on a TODO and select "Create HighFly Issue"
   • The extension automatically captures code context before and after the TODO
   • Code context is stored as a structured CodeBlock with syntax highlighting
   • File path and line numbers are preserved for easy reference

Organization Management

1. Switch Organizations: Use "Highfly: Switch Organization" to change contexts
2. Switch Teams: Use "Highfly: Switch Team" to work with different teams
3. Filter by Assignee: Use the filter options to see issues assigned to you

⚙️ Configuration

The extension provides several configuration options accessible through VS Code settings:

TODO Features

• Run the command "Highfly: Toggle TODO Features" to change settings
  • Hover - Enable hover information for TODOs (default: true)
  • CodeLens - Enable CodeLens for TODOs (default: true)
  • CodeAction - Enable quick actions for TODOs (default: true)
  • Highlighting - Enable syntax highlighting for TODOs (default: true)

🔍 Troubleshooting

Common Issues

1. "State mismatch" error: Try signing in again
2. "Login timeout" error: Check internet connection and try again
3. "Token exchange failed" error: Check backend endpoints are accessible
4. Issues not loading: Verify you're signed in and have access to the organization/team

Debug Information

📝 Release Notes

0.0.5

• Enhanced TODO Integration: Rich code context capture with CodeBlock nodes
  • Automatically captures surrounding code when creating issues from TODOs
  • Preserves file paths, line numbers, and programming language
  • Structured code storage with syntax highlighting support

0.0.1

• Initial release with OAuth authentication support
• Basic issue management and TODO integration
• Multi-organization and team support
• Issue filtering and preview functionality
• Full compatibility with VS Code, Cursor, and Windsurf editors

🔗 For more information

• HighFly Web App