Skip to content

getting-started.md

Latest commit

 

History

History
123 lines (91 loc) · 2.65 KB

getting-started.md

File metadata and controls

123 lines (91 loc) · 2.65 KB
Raw

Getting Started with Task Orchestrator

Start orchestrating AI agents in under 5 minutes.

Installation

Quick Install

# In your own project root
cd /your/project

# Add tm from release artifact or local install
cp /path/to/task-orchestrator/tm ./tm
chmod +x tm
./tm init

Contributor Install (for developing task-orchestrator itself)

git clone https://github.com/T72/task-orchestrator.git
cd task-orchestrator
chmod +x tm
./tm init

System Requirements

  • Python 3.8+ (no dependencies!)
  • Linux, macOS, or Windows (via WSL)
  • 10MB disk space

Your First Task

Create a Simple Task

./tm add "Build authentication system"
# Output: Task created with ID: a1b2c3d4

View Your Tasks

./tm list

Update Task Status

./tm update a1b2c3d4 --status in_progress
./tm complete a1b2c3d4

Dependency Management

Create tasks that depend on each other:

# Create parent task
BACKEND=$(./tm add "Build API" | grep -o '[a-f0-9]\{8\}')

# Create dependent task
FRONTEND=$(./tm add "Build UI" --depends-on $BACKEND | grep -o '[a-f0-9]\{8\}')

# View dependency chain
./tm list

Multi-Agent Assignment

Assign tasks to specialized agents:

# Assign to backend specialist
./tm add "Create database schema" --assignee backend_agent

# Assign to frontend specialist
./tm add "Design user interface" --assignee frontend_agent

# View agent workload
./tm list --assignee backend_agent

Commander's Intent Pattern

Use the WHY/WHAT/DONE pattern for clear communication:

./tm add "Implement auth" --context "WHY: Secure user data
                                    WHAT: Login, 2FA, sessions
                                    DONE: Users can login securely"

Real-Time Monitoring

Watch for task updates:

# In terminal 1: Start monitoring
./tm watch

# In terminal 2: Make changes
./tm complete a1b2c3d4
# Terminal 1 shows: Task a1b2c3d4 completed!

Next Steps

Quick Reference

Command Description
./tm init Initialize database
./tm add "task" Create task
./tm list View all tasks
./tm show ID View task details
./tm update ID --status STATUS Update status
./tm complete ID Mark complete
./tm watch Monitor changes

Getting started takes 5 minutes. Master orchestration in 30.