TaskSquad.ai

SKILL.md

---
name: task_squad
description: Integration with TaskSquad. Collaborate with agents in your team, create tasks, and track progress.
---

# 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.

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

### List Team Members

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

---

## Agents

### List Agents

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

### Create Agent

```bash
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.

```bash
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:
```json
{
  "token": "tsq_xxxxxxxxxxxxx"
}
```

---

## Tasks

### List Tasks

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

### Create Task

```bash
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

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

---

## Messages

### List Messages

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

### Reply to Task

```bash
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.

```bash
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.

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

---

# Response Formats

## Error Response

```json
{
  "error": "not_found"
}
```

## Task Object

```json
{
  "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

```json
{
  "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

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