Traycer

VS Code extension that helps you break down big coding tasks into smaller, manageable pieces. Instead of trying to tackle everything at once, it creates a plan, figures out what depends on what, and helps coordinate the work.

What It Does

Analyzes your code - Looks at TypeScript, JavaScript, and Python files to understand structure, complexity, and what you're working with.

Creates a plan - Takes your goal and breaks it into smaller tasks with proper dependencies. Want to add error handling? It'll figure out what needs to happen first, second, third.

Manages the work - Keeps track of what's done, what's in progress, and what's next. Tasks wait for their dependencies to finish.

Coordinates agents - Each task gets tagged with the right type of agent (refactor, test, fix, etc.) so the right tool handles the right job.

Getting Started

What You Need

• Node.js (v16 or higher)
• VS Code (v1.74 or higher)
• TypeScript

Installation

1. Clone this repo
2. Run npm install
3. Build it with npm run compile
4. Open in VS Code and press F5 to test it

How to Use It

Create a Plan

1. Open any code file in VS Code
2. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
3. Type "Traycer: Plan Tasks"
4. Tell it what you want to do (e.g., "Refactor this function", "Add error handling")
5. It analyzes your code and creates a plan

View Your Plan

1. Open Command Palette
2. Run "Traycer: Show Task Planner"
3. You'll see all your tasks with status, priorities, and dependencies

Execute Tasks

Click "Execute" on any task in the Task Planner. Tasks that aren't ready yet (because their dependencies aren't done) will be disabled automatically.

How It Works

Here's a real example:

You say: "Refactor the authentication module"

Traycer does:

1. Analyzes your auth code - finds complex functions, sees the structure
2. Creates a plan:
   • Task 1: Analyze current implementation (do this first)
   • Task 2: Design new structure (depends on Task 1)
   • Task 3: Extract complex functions (depends on Task 2)
   • Task 4: Add tests (depends on Task 3)
   • Task 5: Update docs (depends on Task 4)
3. You execute tasks in order, and it tracks everything

The Code

The project is split into a few main parts:

• PlanningEngine - The brain that creates task breakdowns
• CodeAnalyzer - Reads and understands your code
• TaskManager - Keeps everything organized and tracks progress
• WebviewProvider - The UI you see in VS Code

Extending It

Right now it simulates task execution, but the hooks are there to connect real coding agents. The executeTask method can call GitHub Copilot, Cursor, or any other agent API you want.

Tasks are already tagged with agent types (refactor, test, fix, implement, design) so you know which agent should handle what.

What Could Be Next?

• Connect to real coding agents
• Analyze multiple files at once
• Learn from past plans to get smarter
• Custom agent types
• Save and share plans with your team