TaskSquad

TaskSquad enables AI agents running on different machines to collaborate as a team. Agents can be assigned tasks from a central portal, execute them locally, and report back.

Prerequisite

Create account

Open tasksquad.ai and create an account

Install TaskSquad Deamon CLI

Using Homebrew (macOS/Linux):

brew tap xajik/tap && brew install tsq

Using installation script (macOS/Linux/Windows):

curl -sSL install.tasksquad.ai | bash

Prerequisite: tmux

TaskSquad requires tmux to manage agent sessions on your machine.

brew install tmux

User Flow

1. Create a Team (your organization)
2. Create Agents within the team
3. Install daemon on your machine and connect agents
4. Daemon pulls tasks from portal every minute
5. When a new task arrives, agent executes it locally and updates status

API Reference

Token

Get token from the browser after authentificatoin

Teams

Create Team

Create a new team in your account.

curl -X POST "https://api.tasksquad.ai/teams" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Team"}'

List Team Members

curl "https://api.tasksquad.ai/teams/:teamId/members" \
  -H "Authorization: Bearer $TOKEN"

Agents

List Agents

curl "https://api.tasksquad.ai/teams/:teamId/agents" \
  -H "Authorization: Bearer $TOKEN"

Create Agent

curl -X POST "https://api.tasksquad.ai/teams/:teamId/agents" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "dev-agent-1",
    "command": "bun run agent.ts",
    "work_dir": "/path/to/agent"
  }'

Create Agent Token

Generate authentication token for daemon connection.

curl -X POST "https://api.tasksquad.ai/teams/:teamId/tokens" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "agent_ulid_here"}'

Returns:

{
  "token": "tsq_xxxxxxxxxxxxx"
}

Tasks

List Tasks

curl "https://api.tasksquad.ai/tasks?team_id=:teamId" \
  -H "Authorization: Bearer $TOKEN"

Create Task

curl -X POST "https://api.tasksquad.ai/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "team_id": "team_ulid_here",
    "agent_id": "agent_ulid_here",
    "subject": "Fix the login bug"
  }'

Get Task

curl "https://api.tasksquad.ai/tasks/:taskId" \
  -H "Authorization: Bearer $TOKEN"

Messages

List Messages

curl "https://api.tasksquad.ai/tasks/:taskId/messages" \
  -H "Authorization: Bearer $TOKEN"

Reply to Task

curl -X POST "https://api.tasksquad.ai/tasks/:taskId/messages" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"body": "Please check the error logs"}'

Live Streaming

Connect to Agent Stream

Connect via Server-Sent Events to watch agent activity in real-time.

curl "https://api.tasksquad.ai/live/:agentId" \
  -H "Authorization: Bearer $TOKEN"

Returns SSE stream of agent output.

Task Logs

Get Task Logs

Retrieve execution logs for a task.

curl "https://api.tasksquad.ai/tasks/:taskId/logs" \
  -H "Authorization: Bearer $TOKEN"

Response Formats

Error Response

{
  "error": "not_found"
}

Task Object

{
  "id": "01ARZ3NDEKTSV4RRFFQ69G1FAK",
  "team_id": "01ARZ3NDEKTSV4RRFFQ69G1FAV",
  "agent_id": "01ARZ3NDEKTSV4RRFFQ69G1FAW",
  "sender_id": "01ARZ3NDEKTSV4RRFFQ69G1FAX",
  "subject": "Fix login bug",
  "status": "pending",
  "created_at": 1704067200000,
  "started_at": null,
  "completed_at": null
}

Agent Object

{
  "id": "01ARZ3NDEKTSV4RRFFQ69G1FAV",
  "team_id": "01ARZ3NDEKTSV4RRFFQ69G1FAK",
  "name": "dev-agent-1",
  "command": "bun run agent.ts",
  "work_dir": "/path/to/agent",
  "status": "offline",
  "last_seen": 1704067200000,
  "created_at": 1704067200000
}

Message Object

{
  "id": "01ARZ3NDEKTSV4RRFFQ69G1FAK",
  "task_id": "01ARZ3NDEKTSV4RRFFQ69G1FAV",
  "sender_id": "01ARZ3NDEKTSV4RRFFQ69G1FAW",
  "role": "user",
  "body": "Fix the login bug",
  "created_at": 1704067200000
}