AI Planner for VS Code

Visual planning and task management extension with AI assistance for VS Code.

Features

• Visual Plan Editor: Create and manage project plans with a visual interface
• Task Management: Organize tasks with priorities, statuses, and filtering
• AI Integration: Get AI assistance for planning items using GitHub Copilot
• Comments System: Add comments to any plan item or task
• AI Responses: Ask AI to update or improve specific items

File Types

.plan Files

Plan files are used for project planning with sections and items:

• Organize plans into sections
• Add items to each section
• Mark items as completed
• Add comments and ask AI for suggestions

.task Files

Task files are used for task management:

• Create tasks with priorities (high, medium, low)
• Track status (todo, in-progress, done)
• Filter tasks by status
• Add comments and get AI assistance

Usage

Creating a New Plan

1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Run "AI Planner: New Plan File"
3. Enter a file name
4. Start adding sections and items

Creating a New Task List

1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Run "AI Planner: New Task File"
3. Enter a file name
4. Start adding tasks

Using AI Assistance

1. Type a comment or question in the input field for any item
2. Click "Ask AI" button
3. AI will analyze the context and provide suggestions
4. AI responses appear below your comment

Generating Plans with AI

1. In a .plan file, use the "Generate Plan with AI" section
2. Describe your project or what you want to plan
3. Click "Generate Plan"
4. AI will create structured sections and items

Requirements

• VS Code 1.85.0 or higher
• GitHub Copilot extension (for AI features)

File Format

Both .plan and .task files use JSON format internally but are displayed with a visual interface.

Plan File Structure

{
  "version": "1.0",
  "title": "Project Plan",
  "description": "Description of the plan",
  "sections": [
    {
      "id": "unique-id",
      "title": "Section Title",
      "items": [
        {
          "id": "item-id",
          "content": "Item description",
          "status": "pending",
          "comments": []
        }
      ]
    }
  ]
}

Task File Structure

{
  "version": "1.0",
  "title": "Task List",
  "description": "Description",
  "tasks": [
    {
      "id": "task-id",
      "content": "Task description",
      "status": "todo",
      "priority": "medium",
      "comments": []
    }
  ]
}

Development

Building

npm install
npm run compile

Running

Press F5 in VS Code to launch a new Extension Development Host window.

Packaging

npm install -g @vscode/vsce
vsce package

License

MIT