# Wrixton

> Documentation for Wrixton — a personal tracker for todos, chores, projects, gifts, shopping, and groceries.

## Docs

- [Wrixton Authentication: API Keys and Configuration](https://docs.wrixton.xyz/authentication.md): Wrixton uses per-user API keys for all access. Learn how to configure your key, use it in CLI commands and direct API requests, and rotate it when needed.
- [track add: Add Todos, Chores, Tasks, Gifts, and More](https://docs.wrixton.xyz/cli/commands/add.md): Add any item kind with track add. Supports todos, chores, tasks, gifts, shopping, groceries, projects, features, and requirements.
- [Edit, Complete, Snooze, and Delete Items in Wrixton](https://docs.wrixton.xyz/cli/commands/editing.md): Modify items after creation with track edit, mark them done with track done, push due dates with track snooze, and remove with track delete.
- [Export, Import, and Calendar Sync with the Wrixton CLI](https://docs.wrixton.xyz/cli/commands/export-import.md): Back up every item and project with track export, restore with track import, and export due dates as an iCalendar file with track ics.
- [track today and track list: Browse and Filter Items](https://docs.wrixton.xyz/cli/commands/list-today.md): track today shows your focus list blended by priority and due date. track list (alias ls) shows all active items, optionally filtered by kind.
- [Manage Projects, Features, and Requirements in Wrixton](https://docs.wrixton.xyz/cli/commands/projects.md): Create standard and engineering projects, add features and requirements, link tasks, and manage the full project lifecycle with the Wrixton CLI.
- [Share Wrixton Lists with Other CLI Users Effortlessly](https://docs.wrixton.xyz/cli/commands/sharing.md): Share your todos, chores, shopping, or grocery lists from the CLI. Grant view-only or edit access, check active shares, and revoke at any time.
- [Configure the Wrixton CLI: API Key and URL Settings](https://docs.wrixton.xyz/cli/configuration.md): Set your Wrixton API key with track config, or use environment variables. The config is stored at ~/.track/config.toml with 600 permissions.
- [Install the Wrixton CLI on macOS or Linux in Minutes](https://docs.wrixton.xyz/cli/installation.md): Install the Wrixton CLI using the provided init.sh script. Requires Python 3.11+. The script creates a venv and symlinks the track binary.
- [Wrixton Item Kinds: Todo, Chore, Task, Gift & More](https://docs.wrixton.xyz/concepts/item-kinds.md): Wrixton has six item kinds: todo, chore, task, gift, shopping, and grocery. Each has unique fields, ID prefixes, and lifecycle behaviors.
- [Wrixton Projects: Features, Tasks, and Requirements](https://docs.wrixton.xyz/concepts/projects.md): Wrixton organizes work into projects with a feature → requirement hierarchy. Tasks attach to any project or to a specific feature.
- [Wrixton Ranking: Priority, Position, and Item Order](https://docs.wrixton.xyz/concepts/ranking.md): Wrixton ranks items by priority (1-5) then manual position within a bucket. Use track pri, track move, and track rank to control order.
- [Wrixton Recurrence: Roll-Forward vs. Spawn-on-Complete](https://docs.wrixton.xyz/concepts/recurrence.md): Wrixton has two recurrence models: roll-forward for chores (no completion history) and spawn-on-complete for todos, tasks, gifts, and more.
- [Back Up and Restore All Your Wrixton Items and Projects](https://docs.wrixton.xyz/guides/backup-restore.md): Back up all your Wrixton items and projects to a JSON file, then restore into a fresh account. Includes done and canceled items in every export.
- [Sync Wrixton Due Dates to Your Calendar Application](https://docs.wrixton.xyz/guides/calendar.md): Export Wrixton due dates as a one-shot .ics file or subscribe to a live calendar feed that updates automatically as you add and snooze items.
- [Daily Workflow: Focus, Add, and Complete Your Items](https://docs.wrixton.xyz/guides/daily-workflow.md): Learn how to use Wrixton day-to-day: check your focus list, add new items with shortcuts, complete tasks, and snooze what can wait.
- [Install Wrixton as a PWA on Your Phone or Computer](https://docs.wrixton.xyz/guides/pwa.md): Wrixton's web app is installable as a Progressive Web App. Add it to your home screen for full-screen access and offline app shell caching.
- [Share Your Todos, Chores, and Groceries in Wrixton](https://docs.wrixton.xyz/guides/sharing.md): Share your todos, chores, shopping, or grocery lists with other users. Grant view-only or edit access, and manage shares from the CLI or Settings.
- [Automate Wrixton with the track.core Python Library](https://docs.wrixton.xyz/integrations/python-library.md): The track.core Python module exposes all Wrixton operations programmatically. Use it in scripts, bots, notebooks, or automation pipelines.
- [Wrixton Home-Screen Widget for iOS with Scriptable](https://docs.wrixton.xyz/integrations/scriptable-widget.md): Show your Wrixton today list on your iPhone or iPad home screen using the free Scriptable app and the included JavaScript widget script.
- [Wrixton: Personal Tracker for Todos, Projects & More](https://docs.wrixton.xyz/introduction.md): Wrixton tracks todos, chores, projects, gifts, shopping, and groceries. Use the CLI, web app, or install it as a PWA on your phone.
- [Wrixton Quickstart: Install the CLI and Add Your First Items](https://docs.wrixton.xyz/quickstart.md): Install the Wrixton CLI, configure your API key, and add your first todo, chore, and project. Go from zero to a populated list in under five minutes.
- [Omnibar: Keyboard-Driven Command Palette for Wrixton](https://docs.wrixton.xyz/web/omnibar.md): Type / in Wrixton's omnibar to open the command palette. Navigate lenses, create items by kind, snooze tasks, and trigger data exports from the keyboard.
- [Wrixton Web App — Browse, Add, and Track from Any Browser](https://docs.wrixton.xyz/web/overview.md): The Wrixton web app runs at projects.wrixton.xyz. Browse todos, chores, projects, shopping, and groceries with keyboard shortcuts and swipe gestures.
- [Wrixton Settings — Sharing, Calendar Sync, and Data Backup](https://docs.wrixton.xyz/web/settings.md): Manage list sharing, subscribe your calendar app to live due dates, and back up or restore your Wrixton data from the Settings page.