Abby:~/Projects/cosmos-todo$ cat README.md

Cosmos Todo Board ✦

A terminal-based kanban TUI for task management with RPi sync and Telegram notifications.

📄 View Source (todo.py) 📄 Study CLI (study.py) 📋 README

> Demo

✦ COSMOS TODO BOARD ✦ Wed Apr 16 14:30 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ○ TODO [4] ◐ IN PROGRESS [2] ● DONE [3] ────────────────── ────────────────── ────────────────── ○ #6 review 152 mt2 ◐ #8 work on 151 proj ● #13 fix car paint •academic •academic •life ○ #7 finish 161 proj ◐ #9 prepare interview •academic •job ● #14 reply LinkedIn ○ #10 reply Handshake •job •job ○ #12 apply internship ● #15 USCIS letter •job •life ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ j/k move · space cycle · a add · 1-4 tab · p push · q quit

> Features

🖥️ Curses TUI

Full terminal UI with keyboard navigation, tag filtering, and real-time updates. No mouse needed.

📡 RPi Sync

Push/pull tasks to Raspberry Pi via rsync over SSH. Access your board from any device on LAN.

📱 Telegram

Send your board to Telegram via OpenClaw agent on RPi5. Get your tasks on your phone.

🏷️ Tag System

life / academic / job tags with color coding. Filter by pressing 1-4 in TUI.

⌨️ CLI Mode

todo add "task" -t job, todo done 5, todo board — scriptable from any shell.

📦 Zero Dependencies

Pure Python stdlib. 620 lines. JSON storage. Works on any system with Python 3.

> Architecture

┌──────────────────┐     rsync      ┌──────────────────┐
│  MacBook Air      │ ───────────── │  Raspberry Pi 5   │
│  ~/.todo/tasks.json│              │  ~/.todo/tasks.json│
│  todo (TUI/CLI)   │              │  openclaw agent    │
└──────────────────┘               │  Telegram bot      │
                                   └──────────────────┘

> Also: Study CLI

A companion tool for generating interactive study sites from course material.

study init 152      # scaffold ~/Desktop/coursework/152/{raw,site}/
study serve 152     # local HTTP server + OpenClaw LLM chat proxy
                    # → http://127.0.0.1:8765/ with POST /chat

> Tech Stack

Python 3 · curses · argparse · JSON · subprocess · rsync · SSH · OpenClaw

cd ../