Starlit

Reach for the stars, stay grounded.

An agent-native personal TODO system where strategy and tactics unite. Projects live in life dimensions (career / physical / cognitive). Tasks are embedded inside Markdown files. Everything is versioned with git.

Two interfaces, one data source:

• MCP Server — agent interface for Claude Desktop, Cursor, and other MCP clients
• Web Dashboard — human interface at http://localhost:4723

Requirements

• Node.js 18.19+
• Git

Installation

npm install -g @robb3n/starlit

Setup

1. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "starlit": {
      "command": "starlit-mcp"
    }
  }
}

Restart Claude Desktop. Starlit will initialize your data directory at ~/starlit-data/ on first run.

2. Start the Dashboard

starlit-dashboard

Open http://localhost:4723 in your browser.

Data

All data lives in ~/starlit-data/ as plain Markdown files — one file per project. The directory is a git repository; every write is automatically committed.

~/starlit-data/
  career/
    learn-rust.md
    build-portfolio.md
  physical/
    morning-routine.md
  cognitive/
    read-100-books.md

To sync across devices, add a git remote and push/pull manually:

cd ~/starlit-data
git remote add origin <your-repo-url>
git push -u origin main

MCP Tools

| Tool | Description | |------|-------------| | create_project | Create a new project in a dimension | | list_projects | List projects, optionally filtered by dimension | | get_project | Get full project content including all tasks | | archive_project | Archive a project | | create_task | Add a task to a project | | update_task | Update task fields (status, due date, tags, etc.) | | list_tasks | Cross-project task list; due_today=true for My Day | | delete_task | Remove a task from a project | | suggest_tasks | Get pending and backlog tasks to work on next |

Dashboard Views

• Overview — strategy grid across all dimensions and projects
• Project Kanban — tasks in Ongoing / Pending / Backlog / Done columns
• My Day — tasks due today, upcoming this week, and suggestions

Configuration

Default config is written to ~/.starlit/config.json on first run:

{
  "dataDir": "~/starlit-data",
  "dimensions": [
    { "id": "career", "label": "Career" },
    { "id": "physical", "label": "Physical" },
    { "id": "cognitive", "label": "Cognitive" }
  ],
  "dashboardPort": 4723
}

License

Copyright © 2026 robb3n. All rights reserved.