# Todos

> Use this skill when the user wants to list, search, create, edit, complete, or replan todos in Aicoo. Triggers on: 'todos', 'my tasks', 'task list', 'add todo', 'create todo', 'complete todo', 'mark done', 'replan', 'overdue tasks', 'what do I need to do', 'pending tasks', 'to-do list', 'check my todos'.

- **Type:** Skill
- **Install:** `agentstack add skill-aicoo-team-aicoo-skills-todos`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Aicoo-Team](https://agentstack.voostack.com/s/aicoo-team)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Aicoo-Team](https://github.com/Aicoo-Team)
- **Source:** https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/todos
- **Website:** https://aicoo.io/docs

## Install

```sh
agentstack add skill-aicoo-team-aicoo-skills-todos
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Todos — Task Management

List, create, edit, complete, and replan todos using Aicoo OS endpoints.

## Prerequisites

- `AICOO_API_KEY` must be set (falls back to `PULSE_API_KEY`)
- Base URL: `https://www.aicoo.io/api/v1`

## API Endpoints

| Endpoint | Method | Purpose |
|----------|--------|---------|
| `/os/todos` | GET | List/search todos |
| `/os/todos` | POST | Create a todo |
| `/os/todos/{id}` | PATCH | Edit a todo |
| `/os/todos/{id}/complete` | POST | Mark todo complete |
| `/os/todos/replan` | POST | Replan overdue todos |

## List Todos

```bash
# All incomplete todos
curl -s "https://www.aicoo.io/api/v1/os/todos?limit=20&completed=false" \
  -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" | jq .

# Search by keyword
curl -s "https://www.aicoo.io/api/v1/os/todos?q=investor&limit=20" \
  -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" | jq .

# Filter by priority (1=highest)
curl -s "https://www.aicoo.io/api/v1/os/todos?priority=1&limit=10" \
  -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" | jq .

# Include completed
curl -s "https://www.aicoo.io/api/v1/os/todos?completed=true&limit=50" \
  -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" | jq .
```

## Create a Todo

```bash
curl -s -X POST "https://www.aicoo.io/api/v1/os/todos" \
  -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"title":"Prepare investor packet","priority":1}' | jq .
```

Fields:
- `title` (required): task description
- `priority` (optional): 1 (highest) to 4 (lowest)
- `dueDate` (optional): ISO 8601 date string
- `notes` (optional): additional context

## Edit a Todo

```bash
curl -s -X PATCH "https://www.aicoo.io/api/v1/os/todos/42" \
  -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"title":"Updated title","priority":2,"dueDate":"2026-05-10"}' | jq .
```

## Complete a Todo

```bash
curl -s -X POST "https://www.aicoo.io/api/v1/os/todos/42/complete" \
  -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" | jq .
```

## Replan Overdue Todos

Reschedule overdue items intelligently:

```bash
curl -s -X POST "https://www.aicoo.io/api/v1/os/todos/replan" \
  -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{}' | jq .
```

## Workflow: Sync Local Todos to Aicoo

When the user has a local todo list (markdown, text file, etc.) and wants it in Aicoo:

1. Read the local file
2. Parse each todo item
3. POST each to `/os/todos` with appropriate priority and due date
4. Report what was created

## Presentation

When listing todos, group by status and priority:

```
Pending (5 items)
  P1: Prepare investor packet (due May 5)
  P1: Fix production auth bug
  P2: Review PR #280
  P3: Update onboarding docs
  P4: Clean up old branches

Completed today (2 items)
  Done: Deploy guest identity fix
  Done: Write LLM judge docs
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Aicoo-Team](https://github.com/Aicoo-Team)
- **Source:** [Aicoo-Team/AICOO-Skills](https://github.com/Aicoo-Team/AICOO-Skills)
- **License:** MIT
- **Homepage:** https://aicoo.io/docs

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aicoo-team-aicoo-skills-todos
- Seller: https://agentstack.voostack.com/s/aicoo-team
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.