# Todoer documentation

> Todoer is an open-source task manager with a web app, REST API, CLI and remote MCP.

Use the guides below as the source of truth. Connect to an existing instance; cloud uses https://app.todoer.pro and self-hosted instances use their own HTTPS origin. CLI uses REST credentials; MCP uses separate OAuth or MCP credentials. Discover capabilities before writes and preserve revision, idempotency and access-review checks.

- [Complete documentation](https://docs.todoer.pro/llms-full.txt): all published guides in one file
- [Agent skill](https://github.com/mattmezza/todoer.pro/blob/main/skills/todoer.pro/SKILL.md): connecting and operating safely

## Start here

- [Getting started](https://docs.todoer.pro/getting-started.md): [human page](https://docs.todoer.pro/getting-started.html)
- [Your first spaces](https://docs.todoer.pro/rebuild/onboarding.md): [human page](https://docs.todoer.pro/rebuild/onboarding.html)
- [Capture tasks](https://docs.todoer.pro/rebuild/smart-capture.md): [human page](https://docs.todoer.pro/rebuild/smart-capture.html)
- [Lists and short links](https://docs.todoer.pro/rebuild/short-ids-defaults.md): [human page](https://docs.todoer.pro/rebuild/short-ids-defaults.html)

## Your everyday workflow

- [Organize your work](https://docs.todoer.pro/rebuild/references.md): [human page](https://docs.todoer.pro/rebuild/references.html)
- [Dates and recurring tasks](https://docs.todoer.pro/rebuild/scheduling.md): [human page](https://docs.todoer.pro/rebuild/scheduling.html)
- [Search](https://docs.todoer.pro/rebuild/search.md): [human page](https://docs.todoer.pro/rebuild/search.html)
- [Weekly review](https://docs.todoer.pro/rebuild/statistics.md): [human page](https://docs.todoer.pro/rebuild/statistics.html)
- [Comments and files](https://docs.todoer.pro/rebuild/attachments.md): [human page](https://docs.todoer.pro/rebuild/attachments.html)
- [Sharing and list moves](https://docs.todoer.pro/rebuild/sharing-moves.md): [human page](https://docs.todoer.pro/rebuild/sharing-moves.html)
- [Move sections](https://docs.todoer.pro/rebuild/section-moves.md): [human page](https://docs.todoer.pro/rebuild/section-moves.html)
- [Notification center](https://docs.todoer.pro/rebuild/notification-center.md): [human page](https://docs.todoer.pro/rebuild/notification-center.html)
- [Notification settings](https://docs.todoer.pro/rebuild/notifications.md): [human page](https://docs.todoer.pro/rebuild/notifications.html)
- [Browser reminders](https://docs.todoer.pro/rebuild/push.md): [human page](https://docs.todoer.pro/rebuild/push.html)
- [Install and use offline](https://docs.todoer.pro/rebuild/pwa.md): [human page](https://docs.todoer.pro/rebuild/pwa.html)
- [Background jobs](https://docs.todoer.pro/rebuild/jobs.md): [human page](https://docs.todoer.pro/rebuild/jobs.html)
- [Loading and recovery](https://docs.todoer.pro/rebuild/loading-states.md): [human page](https://docs.todoer.pro/rebuild/loading-states.html)
- [Readable URLs](https://docs.todoer.pro/rebuild/slugs.md): [human page](https://docs.todoer.pro/rebuild/slugs.html)

## CLI, API and AI

- [CLI sign-in](https://docs.todoer.pro/rebuild/cli-login.md): [human page](https://docs.todoer.pro/rebuild/cli-login.html)
- [CLI and agent workflow](https://docs.todoer.pro/rebuild/agent-workflow.md): [human page](https://docs.todoer.pro/rebuild/agent-workflow.html)
- [Identity and permissions](https://docs.todoer.pro/rebuild/authentication.md): [human page](https://docs.todoer.pro/rebuild/authentication.html)
- [REST API](https://docs.todoer.pro/rebuild/rest.md): [human page](https://docs.todoer.pro/rebuild/rest.html)
- [Task tree queries](https://docs.todoer.pro/rebuild/subtree-query.md): [human page](https://docs.todoer.pro/rebuild/subtree-query.html)
- [Preview and apply changes](https://docs.todoer.pro/rebuild/bulk.md): [human page](https://docs.todoer.pro/rebuild/bulk.html)
- [Optional AI assistance](https://docs.todoer.pro/rebuild/assist.md): [human page](https://docs.todoer.pro/rebuild/assist.html)
- [AI, BYOK and credits](https://docs.todoer.pro/rebuild/ai-billing.md): [human page](https://docs.todoer.pro/rebuild/ai-billing.html)

## Run your own Todoer

- [Deploy with Docker](https://docs.todoer.pro/rebuild/deployment.md): [human page](https://docs.todoer.pro/rebuild/deployment.html)
- [Migration and export](https://docs.todoer.pro/rebuild/migration-export.md): [human page](https://docs.todoer.pro/rebuild/migration-export.html)
- [Back up and restore](https://docs.todoer.pro/rebuild/local-recovery.md): [human page](https://docs.todoer.pro/rebuild/local-recovery.html)
- [Database replication](https://docs.todoer.pro/rebuild/replication.md): [human page](https://docs.todoer.pro/rebuild/replication.html)
- [Builds and releases](https://docs.todoer.pro/rebuild/ci.md): [human page](https://docs.todoer.pro/rebuild/ci.html)