things-app

Canonical home for Gale's Things.app skills and bundled Things MCP server, with plugin-first packaging for Codex and Claude Code.

For maintainer policy and repository workflow expectations, see AGENTS.md.

This repository now bundles three closely related surfaces:

• reusable Things-oriented skills under `skills/`
• the local FastMCP server under `mcp/things-app-mcp/`
• plugin packaging metadata under `plugins/things-app/`

The goal is to keep one canonical repository for:

• reminder-management workflows
• week-ahead digest generation
• the local MCP server those workflows rely on
• install surfaces for Codex and Claude Code

• things-reminders-manager
• Deterministic create and update workflows for Things reminders and scheduled todos.
• things-digest-generator
• Week-ahead planning digests built from Things MCP reads or equivalent JSON exports.

The repository now vendors the former standalone things-app-mcp project at `mcp/things-app-mcp/`, preserving its history via git subtree.

That server remains a self-contained FastMCP package with its own:

• `README.md`
• `pyproject.toml`
• `tests/`
• `docs/`

Run its local checks from that directory:

cd mcp/things-app-mcp
uv sync
uv run pytest

This repository uses a plugin-first layout while keeping root `skills/` as the canonical workflow-authoring surface.

Packaged plugin surfaces live under:

• `plugins/things-app/.codex-plugin/plugin.json`
• `plugins/things-app/.claude-plugin/plugin.json`
• `plugins/things-app/.mcp.json`
• [`plug