Todos Management

Overview

Manages todos via the Nomendex REST API. The API handles all validation, ID generation, timestamps, and ordering automatically.

Todos are displayed in a kanban board UI with columns for each status. Users can drag and drop todos between columns to change their status, or use the API to update status programmatically.

Todo Status

Each todo has a status field that controls which kanban column it appears in. The available statuses are:

Status Description

todo

Not started - the default status for new todos

in_progress

Currently being worked on

done

Completed

later

Deferred or backlogged for future consideration

When creating a todo, status defaults to todo if not specified. When updating a todo's status, the system automatically assigns a new order position at the end of the target column.

Port Discovery

The server writes its port to a discoverable location. Extract it with:

PORT=$(cat ~/Library/Application\ Support/com.firstloop.nomendex/serverport.json | grep -o '"port":[0-9]*' | cut -d: -f2)

API Endpoints

All endpoints use POST with JSON body at http://localhost:$PORT :

Endpoint Description

/api/todos/create

Create a new todo

/api/todos/list

List todos (with optional project filter)

/api/todos/get

Get a single todo by ID

/api/todos/update

Update a todo

/api/todos/delete

Delete a todo

/api/todos/projects

List all projects

/api/todos/tags

List all tags

/api/todos/archive

Archive a todo

/api/todos/unarchive

Unarchive a todo

/api/todos/archived

List archived todos

Create Todo

curl -s -X POST "http://localhost:$PORT/api/todos/create"
-H "Content-Type: application/json"
-d '{"title": "My todo", "project": "work"}'

With explicit status

curl -s -X POST "http://localhost:$PORT/api/todos/create"
-H "Content-Type: application/json"
-d '{"title": "My todo", "status": "in_progress", "project": "work"}'

List Todos

All active todos

curl -s -X POST "http://localhost:$PORT/api/todos/list"
-H "Content-Type: application/json"
-d '{}'

Todos for a specific project

curl -s -X POST "http://localhost:$PORT/api/todos/list"
-H "Content-Type: application/json"
-d '{"project": "work"}'

Update Todo

Update status

curl -s -X POST "http://localhost:$PORT/api/todos/update"
-H "Content-Type: application/json"
-d '{"todoId": "todo-123", "updates": {"status": "done"}}'

Update multiple fields

curl -s -X POST "http://localhost:$PORT/api/todos/update"
-H "Content-Type: application/json"
-d '{"todoId": "todo-123", "updates": {"title": "New title", "status": "in_progress"}}'

How Claude Should Use This Skill

Always start by getting the server port, then use the appropriate endpoint.