todos_skill

Overview

This skill manages project todos via the Nomendex REST API so you can create, view, update, delete, and filter tasks programmatically. It expects the Nomendex app to be running and automatically handles validation, ID generation, timestamps, and ordering on the server side. Use it to drive a kanban-style workflow or to script bulk updates and queries.

How this skill works

The skill discovers the running Nomendex server port from a well-known file, then issues POST requests with JSON bodies to localhost endpoints. It supports endpoints for creating, listing (optionally by project), getting, updating, deleting, archiving, and listing tags or projects. Status changes are reflected in kanban columns and the server assigns ordering automatically.

When to use it

• Create a new todo or set its initial status and project.
• List active todos or list todos filtered by project.
• Update a todo’s status, title, project, or other fields programmatically.
• Delete, archive, or unarchive todos from scripts or automation.
• Query available projects or tags to populate UIs or filters.

Best practices

• Always read the server port from the discoverable file before calling endpoints to avoid hardcoding ports.
• Send JSON POST bodies and set Content-Type: application/json for every request.
• Use the list endpoints with a project filter to reduce payload size when you only need one project.
• When changing status, rely on the server to set ordering; only submit the status field unless you need other updates.
• Respect archived vs active lists: use /api/todos/archived to inspect archived items and /api/todos/archive to move items out of active lists.

Example use cases

• Create a quick task for a project: create a todo with title and project via /api/todos/create.
• Build a dashboard: call /api/todos/list and /api/todos/projects to render a project-filtered kanban board.
• Automate sprint cleanup: list todos by project and archive or delete completed items in bulk.
• Status workflows: move items between todo, in_progress, done, and later by updating the status field.
• Reporting: pull todos filtered by due date or status for progress reports.