122 lines
3.5 KiB
Markdown
122 lines
3.5 KiB
Markdown
---
|
|
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)
|