todo-webapp#

A zero-dependency Node.js web app that turns your TODO.md into a live, interactive task board.

What it does#

• Serves a dark glassmorphism UI at http://<hostname>.local:3456 (LAN only)
• Reads TODO.md directly — ## headings become section cards, ### become subheadings, - [ ]/ - [x] become clickable items
• Live updates via Server-Sent Events: any change to TODO.md (by the agent or anyone else) pushes instantly to all open browser tabs
• Click to toggle: checking an item off saves immediately to TODO.md
• Archive Done button: moves all [x] items to TODO-done.md with a date stamp and removes them from TODO.md
• Auto-starts on boot and self-restarts on crash via macOS launchd

Setup#

1. Copy the server script#

Copy scripts/server.js to your desired app directory (e.g. ~/.openclaw/workspace/todo-app/server.js).

The server expects:

• TODO.md at ../TODO.md relative to the script (i.e. one directory up)
• TODO-done.md at ../TODO-done.md (created automatically if missing)
• bg.jpg in the same directory as the script (optional background image)

2. Add a background image (optional)#

Drop any bg.jpg into the same folder as server.js. It will be rendered at ~22% opacity behind the UI. Works best with abstract or dark imagery.

3. Install the launchd agent#

Copy assets/com.todo.plist.template to ~/Library/LaunchAgents/com.todo.plist.

Edit the plist and update these two values:

• The path to node (run which node to find it)
• The path to server.js

Then load it:

bash

launchctl load ~/Library/LaunchAgents/com.todo.plist

4. Open in browser#

Navigate to http://<your-mac-hostname>.local:3456 from any device on your LAN.

Restart command#

If you update server.js, restart with:

bash

kill $(lsof -ti :3456) && sleep 1 && launchctl kickstart -k gui/$(id -u)/com.todo

TODO.md format#

The app parses standard OpenClaw-style markdown:

markdown

## Section Name

### Subheading

- [ ] Open task
- [x] Completed task
- **Bold text** is rendered in item labels

Any section added to TODO.md appears automatically. No app restart needed.

Port#

Default port is 3456. To change it, edit the PORT constant at the top of server.js.