---

name: todos description: Manages project todos via REST API. Use when the user asks to create, view, update, or delete todos, list tasks by project, check task status, or filter by due date. Requires the Noetect app to be running. version: 1

Todos Management

Overview

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

Port Discovery

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

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

API Endpoints

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

Create Todo

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

List Todos

Copy# 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

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

How Claude Should Use This Skill

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