# Todo List

Keep the workspace's to-dos in one list, and let the Todo Coach say what to work on next.

Small jobs get lost when they live on sticky notes and in people's heads. At Acme Precision, the office keeps one shared Todo List, and the Todo Coach says which item to tackle first and turns overdue work orders into todos.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

The **Todo List** is one page with one list, shared by the whole workspace: everyone who can open it sees the same items, newest first, open and done together.

- **The list**: each row has a tick box, the task, its priority (**critical**, **high**, **medium** or **low**), *from …* when something other than a person added it, and an **x** to delete it. Finished items stay on the list, crossed out.
- **The add row**: **What needs doing?**, a priority, and **Add**.
- **The coach buttons**: **Push me**, **Re-prioritize** and **Scan modules** send a request to the **Todo Coach** in the AI chat. **Help** opens the module's own guide.

Due dates and notes can be kept on an item, but only through the Todo Coach; the page doesn't show them.

## Set it up

A Workspace Admin does this first.

1. Add **Todo List** from the Marketplace.
2. Open **Module Settings** from the ⋮ on the **Todo List** sidebar row. See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540). There you can set:
   - **scan_modules**: the modules **Scan modules** looks in. Out of the box Work Orders and Endpoints (`MAINTENANCE_WORKORDERS,ENDPOINTS`); these are the only two it can read. Leave it empty to switch scanning off.
   - **overdue_threshold_days**: how many days before its due date an item starts to climb in the coach's ranking (3).
   - **auto_import_from_docs**: when on, the coach adds todos it read from a page without asking first. Leave it off to approve each list.
3. Decide who can do what. See [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). Out of the box Viewers see the list, Operators also add and tick items, and only Admins delete items and use the coach's **Push me**, **Re-prioritize**, **Scan modules** and document import. Give those coach permissions to Operators if they should use them.
4. For reading web pages and documents, each person installs and connects the **Data Visions Browser Extension** in Chrome or Edge.
5. Type your first few todos on the page, or tell the Todo Coach about them.

## Add a todo

1. Open **Todo List**.
2. Type the task in **What needs doing?**
3. Pick a priority: **critical**, **high**, **medium** (the default) or **low**.
4. Click **Add**, or press Enter. The new item goes to the top of the list.

To give it a due date or notes, ask the Todo Coach, for example *Add "Renew the forklift inspection", high, due Friday*.

## Mark a todo done

1. Find the item on the list.
2. Tick its box. The title is crossed out and the item stays on the list.
3. To reopen it, untick the box.

You can also tell the coach, for example *I finished the copier lease renewal*, and it ticks the item for you. The page picks up the change within a few seconds.

## Delete a todo

1. Find the item on the list.
2. Click the **x** at the right end of its row.

It is removed at once, with no confirmation and no undo. Deleting needs **Delete todos**; without it the page says *Delete failed*. Ticking an item done is usually the better choice.

## Ask the coach what to do next

1. Open the AI chat panel and pick the **Todo Coach**.
2. Click **Push me** on the Todo List, or ask *What should I do next?* The coach names the one open item to work on now and says why: its priority, its due date and where it came from. Items it has never pushed you on get a small boost.
3. Click **Re-prioritize**, or ask *Re-prioritize my list.* The coach ranks every open item and explains its top pick.

Ranking only orders the list in the chat. It never changes an item's priority. If the chat panel is closed, the buttons show *Open the agent chat panel to use the coach.*

## Find work you owe in other modules

1. Click **Scan modules**, or ask the coach *Scan the other modules for anything I owe.*
2. Read the proposed todos in the chat. From Work Orders it proposes one item, *Review N overdue work orders*, when any are past due. From Endpoints it proposes one item per active alert.
3. Say yes to add them, or tell the coach which to skip. Nothing is added until you agree.

Added items show *from module_scan*. Hover over it to see which module and record it came from. The coach only finds what you could open in those modules yourself.

## Pull todos out of a web page or document

1. Make sure the Data Visions Browser Extension is installed and connected.
2. In the chat, paste the page address and ask the coach to *pull out the todos*.
3. The coach reads the page in your own browser, using your existing sign-ins, and lists the action items it found, each with the page address.
4. Approve the items you want. They appear on the list marked *from doc_scan*.

An item whose page address is already on the list is skipped as a duplicate. On a long page, say *keep going* and the coach continues where it stopped.

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **View todos** | See the todo list. | Admin, Operator, Viewer |
| **Add and update todos** | Add todos, edit them and tick them done (by hand or through the coach). | Admin, Operator |
| **Delete todos** | Remove todos permanently instead of finishing them. **Give with care.** | Admin |
| **Re-rank todos with the AI coach** | Use Push me and Re-prioritize so the coach ranks the list and picks the next item. | Admin |
| **Suggest todos from other modules** | Let the coach look at other modules (such as overdue work orders and open alerts) to propose todos. | Admin |
| **Import todos from documents** | Import action items the coach reads from web pages and documents through the browser extension. | Admin |

## Ask its agent

The **Todo Coach** works with your access and no more. See [Agent chat](article:073c6465-d85c-4364-8768-acf42a3a6a48). Try:

- "What should I do next?" It picks one item, such as *Approve Q4 capex for the tube line*, and says why.
- "Set 'Send updated quote to Northwind' due Thursday."
- "I finished the first-article report for Bluefield." It ticks the item done.

It asks before deleting anything, and it shows what it found in other modules or documents before adding it.

## Good to know

- **The list is shared.** Everyone who can open the Todo List sees the same items, even though the coach speaks of "your" list.
- **The buttons show for everyone.** By default only Admins have the permissions behind **Push me**, **Re-prioritize** and **Scan modules**, so the coach refuses others; the **x** gives *Delete failed* to people without **Delete todos**.
- **The list refreshes itself** every few seconds, so items the coach adds appear without reloading.
- **No filters or sorting.** The page shows every item, newest first. Ask the coach for a ranked view.
- **nudge_tone** appears in Module Settings, but the coach doesn't use it yet.
- The list can be charted on the **Dashboards** page with the **Todo items** dataset. See [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95).

## More help

Click **Help** on the Todo List for the full guide: how the list and the coach work, who can do what, questions and setup. The module has no runbooks yet.


Source: https://datavisions.ai/docs/module-guides/todo-list
