diff --git a/SKILL.md b/SKILL.md index 8577d34..bd8c4cd 100644 --- a/SKILL.md +++ b/SKILL.md @@ -12,18 +12,18 @@ Comprehensive task management integration with Tududi (self-hosted task manageme ### Add a Task to Inbox ```bash -tududi-task-add --name "Task name" --description "Optional description" +scripts/quick-add.sh "Task name" ``` -This adds to Tududi inbox immediately, no project/area required. +This creates a task in Tududi via `POST /api/v1/task` (returns uid). -### Read Inbox Status +### Read All Tasks ```bash -tududi-list-inbox +scripts/tududi-api.sh list-tasks ``` -Returns count + summary of inbox tasks. +Returns tasks with filtering options. ### Get Task Suggestions @@ -38,7 +38,7 @@ Example: "I want to add 'Setup CI/CD'. Suggest priority and project." ## Features -- **Inbox Management**: Quick add to inbox without project/area friction +- **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 @@ -46,37 +46,76 @@ Example: "I want to add 'Setup CI/CD'. Suggest priority and project." ## Bundled Scripts -See `scripts/` for Tududi API wrappers: +Located in `scripts/`: -- `tududi-api.sh` — Core API calls (create task, list, etc.) +- `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: -``` -TUDUDI_API_URL=https://todo.dilain.com/api/v1 -TUDUDI_API_KEY=tt_5e3ac7fc... +```bash +export TUDUDI_API_URL="https://todo.dilain.com/api/v1" +export TUDUDI_API_KEY="tt_5e3ac7fc2bf5ae5162ebac5d1d66dcc2ff9d9d0ab343b9d3d4c5a7c439ef67f5" ``` ## Discord Integration -Daily reminder via cron job (separate configuration). Set schedule in openclaw.json: +Daily reminder via cron job. Configure in OpenClaw config: ```json { "cron": { "jobs": [{ - "schedule": { "kind": "cron", "expr": "0 8 * * 1-5" }, + "name": "tududi-morning-reminder", + "schedule": { "kind": "cron", "expr": "0 8 * * 1-5", "tz": "Europe/Paris" }, "sessionTarget": "main", "payload": { "kind": "systemEvent", - "text": "[Tududi Reminder] Morning task check" - } + "text": "🎯 [Tududi] Morning task check: Show overdue + today's tasks" + }, + "enabled": true }] } } ``` -Fires Mon-Fri at 8:00 AM (customize as needed). +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)