skill-tududi/SKILL.md

---
name: tududi-tasks
description: Manage Tududi tasks from OpenClaw. Create tasks, add to inbox, read status, and get morning reminders (Monday-Friday for Pro area). Use when you need to (1) add a quick task to Tududi inbox, (2) read Tududi inbox/project status, (3) suggest priorities/tags/projects for new tasks, or (4) receive automated daily reminders of tasks and inbox items.
---

# Tududi Tasks Integration

Comprehensive task management integration with Tududi (self-hosted task management system) for creating tasks, managing inbox, suggesting smart priorities/tags/projects, and receiving daily reminders via Discord.

## Quick Start

### Add a Task to Inbox

```bash
scripts/quick-add.sh "Task name"
```

This creates a task in Tududi via `POST /api/v1/task` (returns uid).

### Read All Tasks

```bash
scripts/tududi-api.sh list-tasks
```

Returns tasks with filtering options.

### Get Task Suggestions

When adding a task, ask me to suggest:
- **Priority**: Based on task nature
- **Tags**: Category (work, personal, urgent, etc.)
- **Project**: Best project fit from existing ones
- **Area**: Pro, Personal, Health, etc.

Example: "I want to add 'Setup CI/CD'. Suggest priority and project."
→ I'll return: Priority=High, Project=Infrastructure, Tags=[devops, automation]

## Features

- **Quick Task Creation**: Fast task capture via `POST /api/v1/task`
- **Smart Suggestions**: Analyze task descriptions and suggest priority/tags/projects
- **Daily Reminders**: Weekday mornings (Mon-Fri) for Pro area, custom for others
- **Status Checks**: Read inbox count, upcoming tasks, projects overview
- **No Auto-Sync**: Manual control—you decide what goes where

## Bundled Scripts

Located in `scripts/`:

- `quick-add.sh` — Create task via API endpoint (✅ Working)
- `tududi-api.sh` — Core API calls (list tasks, get metrics, etc.)
- `tududi-suggest.sh` — Analyze task & suggest priority/tags/projects

## Tududi API Endpoints

**Base URL**: `https://todo.dilain.com/api/v1`

**Task Operations**:
- `POST /task` — Create a new task → returns `{uid, name, ...}`
- `GET /tasks` — List tasks with filtering
- `GET /task/{id}` — Get task by ID/UID
- `PATCH /task/{id}` — Update task
- `DELETE /task/{id}` — Delete task

**Authentication**: Use header `Authorization: Bearer {API_KEY}`

## Environment Variables

Must be configured in OpenClaw gateway:

```bash
export TUDUDI_API_URL="https://todo.dilain.com/api/v1"
export TUDUDI_API_KEY="tt_5e3ac7fc2bf5ae5162ebac5d1d66dcc2ff9d9d0ab343b9d3d4c5a7c439ef67f5"
```

## Discord Integration

Daily reminder via cron job. Configure in OpenClaw config:

```json
{
  "cron": {
    "jobs": [{
      "name": "tududi-morning-reminder",
      "schedule": { "kind": "cron", "expr": "0 8 * * 1-5", "tz": "Europe/Paris" },
      "sessionTarget": "main",
      "payload": {
        "kind": "systemEvent",
        "text": "🎯 [Tududi] Morning task check: Show overdue + today's tasks"
      },
      "enabled": true
    }]
  }
}
```

Fires Mon-Fri at 8:00 AM Paris time.

## Testing

```bash
# Set credentials
export TUDUDI_API_URL="https://todo.dilain.com/api/v1"
export TUDUDI_API_KEY="tt_..."

# Test task creation
bash scripts/quick-add.sh "Test task"
# Expected: ✅ Added to Tududi: Test task (uid: xxxxx)

# Test list
bash scripts/tududi-api.sh list-tasks
```

## Status

- ✅ API connectivity verified
- ✅ Quick task creation working (POST /api/v1/task)
- ✅ Scripts tested with real API
- ⏳ "todo [task]" pattern matching (to be implemented in OpenClaw main agent)
- ⏳ Smart suggestions engine (tududi-suggest.sh)