Agent Task Player

A music-player for AI coding tasks: define playlists of tasks and play them sequentially using coding agent CLIs.

Hit Play and watch your agents work through a structured plan, one task at a time — Claude Code, Codex, Gemini CLI, Ollama, or any custom CLI.

Features

Plan Editor

• Side panel tree showing playlists and tasks
• Add, edit, reorder, and delete playlists and tasks inline
• Live status icons: pending, running, completed, failed, skipped

Transport Controls (Play / Pause / Stop)

• Play — runs tasks sequentially across all playlists
• Pause — waits for the current task to finish, then holds
• Stop — kills the running process and halts immediately
• Configurable autoplay delay between tasks

Multi-Engine Support

Run each task with a different AI agent engine:

Engine priority: task override > playlist default > plan default > VS Code setting.

Execution History

• Timestamped logs for every task run
• Stdout, stderr, exit code, and duration captured
• Grouped by date in the History sidebar
• Click any entry to view full details in a Markdown document

Dashboard Webview

• Tabbed UI: Plan / Output / History
• Live output streaming during execution
• Inline play/pause/stop controls and status badge

Verification Commands

• Attach a shell command (e.g., npm test) to any task
• Runs automatically after a successful task — if it exits non-zero, the task is marked as failed

Quick Start

1. Install the extension from the VS Code Marketplace (or install from .vsix)
2. Click the Agent Task Player icon in the Activity Bar (rocket icon)
3. Click New Plan to create a .agent-plan.json file in your workspace
4. Add playlists (groups/phases) and tasks (individual agent instructions)
5. Ensure at least one agent CLI is installed and on your PATH (e.g., claude, codex)
6. Hit Play and watch the output stream in the Dashboard

Plan File Format

Plans are stored as .agent-plan.json files. The extension auto-loads the first one found in your workspace.

{
  "version": "1.0",
  "name": "My Project Plan",
  "description": "Optional description",        // optional
  "defaultEngine": "claude",                     // global default engine
  "playlists": [
    {
      "id": "pl-setup",
      "name": "Setup",
      "engine": "claude",                        // optional playlist-level override
      "autoplay": true,                          // auto-advance to next task (default: true)
      "autoplayDelay": 3000,                     // optional delay override (ms)
      "tasks": [
        {
          "id": "task-1",
          "name": "Initialize project",
          "prompt": "Create a new Node.js project with TypeScript and Express",
          "engine": "codex",                     // optional task-level override
          "cwd": "./backend",                    // optional working directory
          "files": ["package.json", "tsconfig.json"],  // context files
          "verifyCommand": "npm test"            // optional verification
        }
      ]
    }
  ]
}

Task Fields

Configuration Reference

Open VS Code Settings (Ctrl+,) and search for agentTaskPlayer:

Commands Reference

All commands are available via the Command Palette (Ctrl+Shift+P):

Supported Engines

Development

Prerequisites

• Node.js 20+
• VS Code 1.85.0+

Setup

git clone https://github.com/sujan-poudel-03/moag.git
cd moag
npm install

Build

npm run compile    # one-time build
npm run watch      # watch mode

Test

npm run test:unit          # unit tests (Mocha + Sinon)
npm run test:integration   # integration tests (VS Code Extension Host)
npm test                   # alias for test:unit

Lint

npm run lint

Package

npm run package    # produces a .vsix file

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Make your changes and add tests
4. Run npm run lint && npm test to verify
5. Commit and push
6. Open a Pull Request

Roadmap

• Parallel task execution within a playlist
• Drag-and-drop reordering in the tree view
• Task templates and snippet library
• Cost/token tracking per engine
• Plan import/export and sharing

License

MIT