> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Todo

> Your own todo list: a page to keep it, tools for the agent, and reminders on the day a todo is due.

Todo keeps your own list of things to do. It comes with Archetype and is on by default. General setup is in [Plugins](https://docs.archetype.ing/en/extend/plugins.md).

## In the sidebar

**Todo** opens the list. Each todo has a title, a note, a status (**To do**, **Doing**, **Blocked** or **Done**), a due day with an optional time, and a repeat (every day, chosen weekdays, or a date each month; the 31st means the last day in shorter months). A blocked todo can say who or what it waits on.

When you mark a repeating todo done, the next one is added with its next due day.

## What the agent can do

| Tool | What it does |
| - | - |
| `list_todos` | Reads your list, open ones first. Finds todos by words or status. Read only. |
| `add_todo` | Adds a todo when you ask for one. |
| `update_todo` | Changes a todo's title, note, status, due day and time, repeat, or what it waits on. |
| `remove_todo` | Deletes a todo when you ask. Finishing one is marking it done, not this. |

Reading runs without asking. Adding, changing and removing follow your [approval mode](https://docs.archetype.ing/en/use/approvals.md).

## Todos found while you were away

When the agent finds a todo without you (in a schedule reading your mail or chats, for example), it does not put it straight on your list. It waits in **Notifications** (**Add to todos** or **Dismiss**) and at the top of the list under **Found for you** (**Accept** or **Dismiss**). Other plugins send todos the same way: Recordings sends a meeting's action items.

A todo a colleague hands you from your company waits there too. Accepting it or dismissing it is your answer, and the company is told. The agent cannot answer it for you. See [Archetype for Teams](https://docs.archetype.ing/en/teams/overview.md).

## Notices

`todo.due`: on its due day, an open todo is told once, from 8 in the morning in your time zone, or from its time when it has one. Archetype checks every 5 minutes, so a time is told within 5 minutes of it. Done todos and todos still waiting in Notifications are not told.

You can wake an agent with this notice in [Automations](https://docs.archetype.ing/en/use/automations.md).

## Today

With **Show today on Arch** on, todos you are doing, due today or overdue show beside Arch. Blocked and waiting todos stay out.

## Profile

**Chief of staff** briefs your day each morning at 8 (meetings, todos due, mail that wants a reply, what waits on you) and reminds you when a todo comes due, with a first small step. It asks before it acts. See [Agents](https://docs.archetype.ing/en/use/agents.md).

## Turn it off

Turn it off in **Manage → Plugins**, or set `"plugins": { "todo": false }` in `~/.config/archetype/config.json`. Your list is kept.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.