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.