sort

sort is the inbox for everything happening in your life. Send it anything — a syllabus PDF, a screenshot, a link, a job listing, a half-formed thought — and sort figures out what it is, what matters, and where it belongs.

A syllabus becomes deadlines and course context. A job listing becomes an opportunity and a reminder. A café link becomes a saved place. A casual message becomes a task, event, or fact worth remembering. The chat interface is just the fastest way to send something to sort; the product is the sorting layer underneath.

The loop: send anything → understand what it contains → sort it into the right kind of context → connect it with what was sorted before → bring it back or act on it when it matters.

Built as a Spectrum project. Wired with: imessage.

Environment

Before running, open .env and fill in the values:

From your project Settings on the Photon dashboard:

• PROJECT_ID
• PROJECT_SECRET

Run the iMessage worker

npm install
npm run start

npm run start connects the real Spectrum/iMessage worker and starts the reminder loop. Use npm run dev only when you want that worker to restart after source changes.

Run the browser demo locally

No Vercel or Railway deployment is required for local testing. The browser demo uses the same Supabase and Anthropic server credentials as the worker, but it does not connect to Photon:

npm run demo:dev

Then open http://localhost:3000/demo/. The local server enables the demo with development-only token secrets; it still needs the shared server values documented in .env.example. Apply supabase/schema.sql once before testing a schema change.

Landing page

The public landing page lives in web/ as a static file (web/index.html). Its preview is scripted and makes no model calls; the dedicated /demo/ route is the real interactive demo. The design was originally ported from a Claude Design source file; that file's support.js runtime is a design-tool dependency and is deliberately not shipped.

Use npm run demo:dev to preview both surfaces with the correct local API routing.

Where to go next

• Spectrum docs
• Add more providers from spectrum-ts/providers/*.

Phase 3 validation

See PHASE3.md for the retrieve/plan architecture, verification commands, bounded live demo, and current limitations.

Phase 4 validation

See PHASE4.md for the proactive reminder loop, deterministic timing rules, real remind:now path, and live acceptance evidence.