Autoplans.dev - AI-Powered Project Management for VS Code

🎯 Your Intelligent Coding Companion - Inspired by GitHub Copilot

Transform VS Code into an AI-powered development hub with autoplans.dev - featuring a default chat agent that understands natural language, manages projects intelligently, and integrates seamlessly with your workflow.

🚀 Why Autoplans.dev?

Stop context switching. Start shipping faster.

Autoplans.dev brings AI-powered project management directly into your IDE with a default chat agent inspired by GitHub Copilot's architecture. Chat naturally, manage tasks, generate documentation, and let AI handle project coordination while you focus on writing great code.

Perfect for AI-Assisted Development

🤖 Default Chat Agent - Intelligent assistant that understands context and natural language
💬 Conversational Task Management - Use @autoplans to create, update, and track tasks naturally
🎯 Smart Project Matching - AI automatically matches your requests to the right projects
🧠 Context-Aware AI - Remembers conversation history and preferences
📝 Auto-Generated Documentation - Creates .github/copilot-instructions.md and .autoplans/ folders
⌨️ Keyboard Shortcuts - Fast access with Ctrl+Shift+A, Ctrl+Alt+A, Ctrl+Alt+P
🎨 Beautiful UI - Rich formatting with emojis, progress bars, and interactive buttons

✨ Key Features

🤖 Default Chat Agent - NEW!

Our intelligent chat agent works like GitHub Copilot but for project management:

Natural Language Understanding:

@autoplans Show me all my projects
→ Lists projects grouped by status with task counts

@autoplans Create a task for the API project to implement OAuth
→ Intelligently finds "API" project, confirms, then creates task

@autoplans What's the status of my work?
→ Shows comprehensive dashboard with progress bars

@autoplans Sync my project documentation to GitHub
→ Presents sync options with action buttons

8 Powerful Slash Commands:

/help - Comprehensive help with examples
/projects - View all projects with status breakdown
/tasks - List tasks (optionally filtered by project)
/create - Interactive project/task creation wizard
/sync - Documentation sync operations
/plan - Create business plans
/brand - Set up project branding
/status - Overall status dashboard with progress

Intelligent Features:

🔍 Smart Matching - Finds projects by name or context
✅ Confirmation Flows - Always asks before major operations
📊 Rich Formatting - Tables, progress bars, status indicators
🎯 Contextual Menus - Shows relevant actions based on state
🔄 Conversation Memory - Remembers what you talked about

🤖 Specialized Chat Agents - NEW!

Agents are specialized AI assistants with specific expertise:

@ProjectPlanner Agent

📋 Research and plan entire projects with multi-step task breakdowns
Analyzes requirements, creates phases, identifies dependencies
Usage: @ProjectPlanner Plan a REST API for a blog platform

@TaskBreakdown Agent

✂️ Break down complex features into manageable, actionable tasks
Defines acceptance criteria, estimates effort, maps dependencies
Usage: @TaskBreakdown Break down "Add OAuth authentication"

📝 Reusable Prompt Files - NEW!

Prompt templates for common operations:

#saveToAutoplans Prompt

💾 Save conversations as structured Autoplans projects
Extracts tasks, organizes into phases, creates in Autoplans
Usage: After planning discussion, type #saveToAutoplans

#syncToGithub Prompt

🔄 Generate and sync documentation to GitHub repository
Creates .github/copilot-instructions.md and .autoplans/ folder
Usage: #syncToGithub to generate all project docs

Complete Workflow Example:

1. @ProjectPlanner Plan a todo app with React
2. #saveToAutoplans (saves as project with tasks)
3. #syncToGithub (generates documentation)
4. Start coding with full context!

📋 Complete Project & Task Management

Project Operations:

✅ List Projects - View all projects with filters (planning, in_progress, completed, archived)
➕ Create Project - Start new projects with GitHub repo linking
📊 Get Project Details - View comprehensive project info and task counts
🌐 Open in Browser - Quick access to web dashboard

Task Operations:

📝 Create Tasks - With title, description, priority (low/medium/high/critical), and type (coding/design/documentation/testing/other)
📋 List Tasks - Filter by status (pending, in_progress, blocked, completed, failed, waiting_for_review)
✏️ Update Tasks - Modify status, priority, assignment (unassigned/ai-agent/user), title, description
🗑️ Delete Tasks - Permanently remove tasks
📊 View Task Details - See full task information with subtasks
⚡ Bulk Operations - Create or update multiple tasks at once

💼 Business Planning & Branding

Business Plan Management:

📄 Create Business Plan - Mission, vision, executive summary, tagline
👀 View Business Plan - Access project strategy and goals
✏️ Update Business Plan - Keep business strategy current

Brand Identity:

🎨 Create Branding - Colors (primary/secondary with hex/rgb), logos, brand name, tagline
👁️ View Branding - Access brand identity guidelines
🖌️ Update Branding - Maintain consistent visual identity

🎯 GitHub Copilot Enhancement

Custom Instructions - AI-generated .github/copilot-instructions.md tailored to YOUR codebase
Project-Specific Chatmodes - Specialized AI planning agent in .github/chatmodes/Autoplanner.chatmode.md
Convention Discovery - Automatically scans .cursorrules, .windsurfrules, .clinerules, AGENT.md
Context Synchronization - Keeps Copilot aware of your project structure and conventions
One-Click Generation - Right-click project → "Generate Copilot Configuration"

📁 Automated Documentation System

.autoplans/ Folder Structure:

README.md - Project overview and autoplans integration
architecture.md - System design and technical decisions
tasks.md - Markdown task list synchronized from API
tasks/*.md - Individual task documentation files

Sync Commands:

🔄 Generate Copilot Config - Creates .github/copilot-instructions.md and chatmodes
📂 Initialize .autoplans Folder - Sets up complete documentation structure
⚡ Sync Project to Repository - Updates both .github/ and .autoplans/ in one command

Tree View Features:

📊 Hierarchical Display - Projects with expandable task lists
🏷️ Status Icons - Visual indicators: ⏳ pending, 🔄 in progress, ✅ completed, ⛔ blocked
📈 Task Counts - See project progress at a glance
🔄 Auto-Refresh - Keep data synchronized with server
🖱️ Context Menus - Right-click for quick actions

Inline Actions:

Project level: View details, open in browser, create task, AI chat, sync operations
Task level: View details, update status, open in browser

🤖 27 Language Model Tools

All features accessible via AI chat participants (Copilot, Cursor, Windsurf, Cline):

Projects: list, create, get
Tasks: list, create, update, delete, get, bulk_create, bulk_update
Subtasks: create, list
Comments: create, list, update, delete (add comments to tasks)
Assignments: assign_task, list_user_assigned_tasks
Business: get/create/update business plans
Branding: get/create/update branding
Sync: generate_copilot_config, initialize_autoplans_folder, sync_project_to_repo

🛡️ Security & Privacy

Secret Storage - API keys encrypted in VS Code's built-in secret manager
Local-First - Project detection works offline without server calls
No Telemetry - We don't track your usage or collect analytics
Open Source - Full transparency - inspect the code yourself
HTTPS Only - All API communication encrypted

🎬 Quick Start

1. Install the Extension

From VSIX (Current):

Download autoplans-vscode-0.1.9.vsix
Open VS Code → Extensions (Ctrl+Shift+X)
Click "..." → "Install from VSIX..."

From Marketplace (Coming Soon): Search for "Autoplans.dev" in Extensions

2. Get Your API Key

Visit autoplans.dev/dashboard/settings
Create a new API key
Copy the key (starts with apk_live_)

3. Configure VS Code

# Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
> Autoplans: Set API Key
# Paste your API key

4. Start Coding Smarter

Use the Chat Interface

Ctrl+Alt+I (Windows/Linux) or Cmd+Alt+I (Mac)

@autoplans help
@autoplans generate copilot config
@autoplans create project "My SaaS App"

Click Autoplans icon in Activity Bar
Browse projects and tasks
Right-click for quick actions

🎯 Perfect For

🚀 Startup Developers - Move fast without losing track of features
👥 Solo Developers - AI-assisted planning and task breakdown
🤖 AI-First Teams - Maximize Copilot, Cursor, and Windsurf effectiveness
📦 Open Source Maintainers - Organize issues and contributions
🎓 Learning Developers - Structure projects with AI guidance

💡 Use Cases

For GitHub Copilot Users

Before: Generic Copilot suggestions that don't understand your project After: Context-aware AI that knows your architecture, conventions, and current tasks

For Task Management

Before: Switching between Jira, Trello, or Linear and VS Code After: Manage everything in your IDE with conversational AI

For Documentation

Before: Manually writing and updating project docs After: AI generates and maintains comprehensive documentation automatically

For Team Collaboration

Before: Onboarding requires hours of explanation After: AI instructions guide new developers instantly

🛠️ Commands Reference

Essential Commands

Command	Shortcut	Description
`Autoplans: Set API Key`	-	Configure API authentication
`Autoplans: Test Connection`	-	Verify API connectivity
`Autoplans: Open AI Chat`	`Ctrl+Alt+I`	Start chat with `@autoplans`
`Autoplans: Refresh`	-	Reload data from server
`Autoplans: Show Welcome`	-	Display welcome screen

Project Management Commands

Command	Description
`Autoplans: List Projects`	View all projects with filters
`Autoplans: Create Project`	Start new project with optional GitHub URL
`Autoplans: Show Project Details`	View comprehensive project information
`Autoplans: Open Projects Panel`	Open sidebar dashboard view

Task Management Commands

Command	Description
`Autoplans: List Tasks`	Show all tasks in selected project
`Autoplans: Create Task`	Add new task with priority and type
`Autoplans: Show Task Details`	View and update task information

Documentation & Sync Commands

Command	Description
`Autoplans: Generate Copilot Configuration`	Create `.github/copilot-instructions.md` and chatmodes
`Autoplans: Initialize .autoplans Folder`	Generate `.autoplans/` documentation structure
`Autoplans: Sync Project to Repository`	Update both `.github/` and `.autoplans/` folders

AI Integration Commands

Command	Description
`Autoplans: Request AI Agent`	Request AI assistance for current project
`Autoplans: Open AI Chat`	Launch conversational task interface

Developer Commands

Command	Description
`Autoplans: List Available Tools`	Show all registered Language Model Tools
`Autoplans: Debug Registered Tools`	Troubleshoot tool registration

🎨 Screenshots

Visual project and task management:

📋 Hierarchical Structure - Projects with expandable task lists
🏷️ Status Icons - ⏳ Pending, 🔄 In Progress, ✅ Completed, ⛔ Blocked, ⏸️ Waiting for Review
📊 Task Counts - Progress indicators on each project
🖱️ Context Menus - Right-click for quick actions
🔄 Auto-Refresh - Keep data synchronized

Chat Interface

Conversational AI task management:

@autoplans I found a bug in the authentication system, 
create a critical task to fix it

✅ Created task "Fix authentication bug" with priority: critical

AI-Generated Documentation

.github/copilot-instructions.md - Intelligent project-specific instructions:

� Architecture overview from your actual code structure
🔄 Development workflows extracted from conventions
📝 Project-specific patterns and best practices
🎯 Task management integration for context-aware AI
🤖 Auto-generated by analyzing your codebase

.autoplans/ Structure:

.autoplans/
├── README.md              # Project overview
├── architecture.md        # System design
├── tasks.md              # Task list (markdown)
└── tasks/
    ├── task-001.md       # Individual task docs
    └── task-002.md

Context Menus

Project Context Menu:

📊 Show Project Details
🌐 Open in Browser
💬 Open AI Chat
➕ Create Task
⚙️ Generate Copilot Config
📂 Initialize .autoplans Folder
🔄 Sync Project to Repository

Task Context Menu:

📄 Show Task Details
✏️ Update Status/Priority
🌐 Open in Browser

⚙️ Configuration

Settings

{
  // MCP API Endpoint (default: production)
  "autoplans.mcpEndpoint": "https://autoplans.dev/api/v1/mcp",
  
  // For local development
  // "autoplans.mcpEndpoint": "http://localhost:3000/api/v1/mcp"
}

Keyboard Shortcuts

Action	Windows/Linux	macOS
Open Chat	`Ctrl+Alt+I`	`Cmd+Alt+I`
Command Palette	`Ctrl+Shift+P`	`Cmd+Shift+P`

Language Model Tools Configuration

All 27 Language Model Tools are automatically registered and available to:

GitHub Copilot Chat
Cursor AI
Windsurf AI
Cline AI Assistant
Any VS Code AI extension using the Language Model Tools API

Available Tool Tags:

autoplans - Core autoplans functionality
projects - Project management
tasks - Task operations
business - Business planning
branding - Brand identity
sync - Documentation synchronization
copilot - GitHub Copilot integration
github - GitHub repository operations

🤝 Integration with AI Tools

GitHub Copilot

✅ Full Integration:

Custom .github/copilot-instructions.md generation
Project-specific chatmodes in .github/chatmodes/Autoplanner.chatmode.md
27 Language Model Tools accessible via @autoplans chat participant
Task-aware code suggestions with project context
Automatic convention discovery from your codebase

Usage:

@autoplans create a feature for user authentication
@autoplans list pending tasks
@autoplans generate copilot config

Cursor

✅ Seamless Integration:

Reads .cursorrules for project conventions
Syncs with Cursor's AI context automatically
All Language Model Tools available in Cursor Chat
Compatible with Cursor's composer mode
Project structure understanding from .autoplans/ docs

Auto-Discovery: Extension scans for .cursorrules when generating Copilot instructions.

Windsurf

✅ Native Support:

Integrates with .windsurfrules configuration
Shares project knowledge and conventions
Language Model Tools accessible in Windsurf AI
Documentation sync keeps Windsurf context fresh

Auto-Discovery: Extension reads .windsurfrules during setup.

Cline

✅ Full Compatibility:

Works with .clinerules conventions
Unified AI workspace across tools
All 27 tools available to Cline agent
Task management integrated with Cline workflows

Auto-Discovery: Automatically includes .clinerules in analysis.

Other AI Tools

Works with any VS Code extension that supports:

Language Model Tools API (vscode.lm.tools)
Chat Participants API
Extension-provided AI context

📚 Documentation

Chat Guide - Complete guide to using @autoplans chat
Developer Guide - Contributing and development setup
Quick Start - Get productive in 5 minutes
Changelog - Version history and updates

🔒 Privacy & Security

✅ Local-First - Project detection works offline
✅ Secure Storage - API keys encrypted in VS Code secrets
✅ No Telemetry - We don't track your usage
✅ Open Source - Inspect the code yourself

🐛 Troubleshooting

API Key Issues

# Test your connection
> Autoplans: Test Connection

# Common fixes:
1. Verify key starts with 'apk_live_'
2. Generate new key at autoplans.dev/dashboard/settings
3. Re-run: Autoplans: Set API Key
4. Check API endpoint in settings (should be https://autoplans.dev/api/v1/mcp)

Connection Problems

Symptoms: "Connection Failed" or timeout errors

Solutions:

Check internet connection
Verify autoplans.mcpEndpoint setting:
- Open Settings → Extensions → Autoplans.dev
- Default: https://autoplans.dev/api/v1/mcp
Try accessing autoplans.dev in browser
Check firewall/proxy settings
View logs: Help → Toggle Developer Tools → Console

Projects Not Loading

Symptoms: Empty sidebar or "No projects found"

Solutions:

Click refresh icon (🔄) in sidebar
Run > Autoplans: Refresh from Command Palette
Verify you have projects at autoplans.dev/dashboard
Check API key is valid with > Autoplans: Test Connection
Check Developer Console for errors

Chat Participant Not Responding

Symptoms: @autoplans doesn't respond

Solutions:

Verify extension is activated (check sidebar icon)
Try: @autoplans help
Restart VS Code
Check extension is enabled: Extensions → Autoplans.dev
View activation logs in Output panel → Autoplans

Language Model Tools Not Available

Symptoms: Tools not showing in Copilot or other AI assistants

Solutions:

Run > Autoplans: List Available Tools (should show 27 tools)
Run > Autoplans: Debug Registered Tools for diagnostics
Ensure VS Code version is 1.80.0 or higher
Restart VS Code after installation
Check AI tool supports Language Model Tools API

Documentation Generation Fails

Symptoms: Copilot config or .autoplans folder not created

Solutions:

Ensure you have write permissions in workspace
Check workspace is a valid folder (not untitled)
Verify project exists with > Autoplans: List Projects
Try manual commands:
- > Autoplans: Generate Copilot Configuration
- > Autoplans: Initialize .autoplans Folder
Check Output panel for error details

Performance Issues

Symptoms: Slow loading or freezing

Solutions:

Reduce project count (archive old projects)
Clear VS Code cache: Close VS Code → Delete ~/.vscode/ cache
Check network latency to autoplans.dev
Disable auto-refresh if on slow connection
Use local-first mode when offline

🗺️ Roadmap

Version 0.2.0 (Coming Soon)

[ ] 🌐 VS Code Marketplace publication
[ ] 📊 Task analytics and productivity insights
[ ] 🔔 Desktop notifications for task updates
[ ] 🎨 Customizable status icons and colors

Version 0.3.0 (Planned)

[ ] 💾 Offline mode with local SQLite database
[ ] 🔄 Real-time sync improvements
[ ] 📱 Mobile companion app integration
[ ] 🤝 Multi-workspace support

Version 0.4.0 (Future)

[ ] 🔗 GitHub PR/Issue integration
[ ] 💬 Slack and Discord notifications
[ ] ⏱️ Time tracking and estimates
[ ] 📅 Calendar view for deadlines
[ ] 🎯 Milestone tracking
[ ] 📈 Burndown charts

Community Requests

Vote on features at GitHub Discussions

Current Version: 0.1.9

Latest Changes:

✅ 27 Language Model Tools (including comments, subtasks, assignments)
✅ AI Chat Participant with conversation history
✅ Intelligent project detection from workspace
✅ User confirmation workflow for project operations
✅ AI-powered Copilot instructions generation
✅ Business plan and branding management
✅ Bulk task operations
✅ Complete sync commands
✅ Task comments and assignment features

🤝 Contributing

We welcome contributions! See DEVELOPER.md for setup instructions.

📄 License

MIT License - see LICENSE.txt

🔗 Links

Website: autoplans.dev
Dashboard: autoplans.dev/dashboard
Documentation: docs.autoplans.dev
GitHub: github.com/mohamedgb00714/autoplans.dev

💬 Support

📧 Email: support@autoplans.dev
💬 Chat: Available in dashboard
🐛 Issues: GitHub Issues

Made with ❤️ for developers who code with AI

Autoplans.dev - Your AI-powered development companion in VS Code

Autoplans.dev - AI Project Manager

Auto Plans Dev

Autoplans.dev - AI-Powered Project Management for VS Code

🚀 Why Autoplans.dev?

Perfect for AI-Assisted Development

✨ Key Features

🤖 Default Chat Agent - NEW!

🤖 Specialized Chat Agents - NEW!

📝 Reusable Prompt Files - NEW!

📋 Complete Project & Task Management

💼 Business Planning & Branding

🎯 GitHub Copilot Enhancement

📁 Automated Documentation System

🎨 Visual Sidebar Integration

🤖 27 Language Model Tools

🛡️ Security & Privacy

🎬 Quick Start

1. Install the Extension

2. Get Your API Key

3. Configure VS Code

4. Start Coding Smarter

Use the Chat Interface

Or Use the Sidebar

🎯 Perfect For

💡 Use Cases

For GitHub Copilot Users

For Task Management

For Documentation

For Team Collaboration

🛠️ Commands Reference

Essential Commands

Project Management Commands

Task Management Commands

Documentation & Sync Commands

AI Integration Commands

Developer Commands

🎨 Screenshots

Sidebar Tree View

Chat Interface

AI-Generated Documentation

Context Menus

⚙️ Configuration

Settings

Keyboard Shortcuts

Language Model Tools Configuration

🤝 Integration with AI Tools

GitHub Copilot

Cursor

Windsurf

Cline

Other AI Tools

📚 Documentation

🔒 Privacy & Security

🐛 Troubleshooting

API Key Issues

Connection Problems

Projects Not Loading

Chat Participant Not Responding

Language Model Tools Not Available

Documentation Generation Fails

Performance Issues

🗺️ Roadmap

Version 0.2.0 (Coming Soon)

Version 0.3.0 (Planned)

Version 0.4.0 (Future)

Community Requests

Current Version: 0.1.9

🤝 Contributing

📄 License

🔗 Links

💬 Support