Skip to main content
Wrixton is a small, opinionated personal tracker with a fast Python CLI and a React web UI at projects.wrixton.xyz. Whether you want to stay on top of recurring chores, manage a multi-stage home-renovation project, track gifts for family, or simply remember to buy milk, everything lands in one place — searchable, prioritizable, and available on any device.

​
What you can track

Wrixton organizes everything into six item kinds, each tailored to a specific tracking pattern:
  • Todo — A one-off task you need to complete, optionally recurring. Todos carry a priority (1–5), an optional due date, tags, and a time estimate. Use them for anything that doesn’t belong to a project.
  • Chore — A repeating household or personal task defined by how often it needs doing (--every) and when you last did it (--last-done). A chore is never marked “done” in the traditional sense; its next-due date rolls forward automatically from last_done + every.
  • Task — A todo that lives inside a project, linked to a project slug. Tasks appear under their project in track projects and are affected when you complete or reopen the whole project.
  • Gift — A present to acquire and give. Gifts support a recipient, an occasion, a budget, and a two-stage status flow: bought (you have it) → given (you’ve handed it over).
  • Shopping — A one-off thing to buy that isn’t a grocery item. Shares the s- ID prefix with gifts but lives in its own tab. Supports an optional budget and URL.
  • Grocery — Something to add to your shopping cart on the next grocery run. The store (Costco, Trader Joe’s, Safeway) rides along as a plain tag, so the tag filter doubles as a per-store view.

​
How you interact with Wrixton

CLI — The primary interface for daily use. The track command is a thin Python client (stdlib urllib only) that talks to the hosted HTTP API authenticated with your personal API key. Run track today for a prioritized focus list, track ls for everything, and track add <kind> to create new items. Web UI — A React + Vite app hosted at projects.wrixton.xyz. It mirrors all CLI features and adds conveniences like inline snooze buttons, an omnibar with slash commands (/todo, /export, /calendar), and a Completed view that groups finished items by when they were done. PWA — The web UI ships a full web-app manifest and service worker, so you can install it to your phone’s home screen or desktop via “Add to Home Screen.” It opens full-screen, caches the app shell for offline use, and stays responsive with optimistic updates while waiting for the network.

​
Authentication model

Every user has one API key, generated when their account is created with track user add. The CLI reads it from ~/.track/config.toml (written by track config) or from the TRACK_API_KEY environment variable. All HTTP requests — from the CLI and directly against the API — pass the key as the x-track-key header. The web UI stores it in localStorage after a one-time paste on the login screen.

Quickstart

Install the CLI and add your first items in under five minutes.

Item Kinds

Dive deeper into todos, chores, tasks, gifts, shopping, and groceries.

CLI Installation

Full install instructions, PATH setup, and shell configuration.

Web UI Overview

Explore the web app, PWA install, omnibar commands, and calendar feed.