To-do lists

Keep a personal list of issues and free-text tasks per repository, and start work from it.

The To-do section in the left sidebar is a personal shortlist for the repository you're in. Pull in the issues you plan to tackle, jot down free-text tasks, and start an AI agent straight from a task. Your lists are private to your machine and scoped per repository, so each repository shows its own.

Two kinds of item#

A to-do item is one of two things:

• An issue you've curated from GitHub or Jira. It shows the issue key and live title, and opening it brings up the full issue.
• A free-text task you typed yourself. It's just a line of text, and you can start an AI agent from it.

You can keep several named lists per repository (for example one per milestone). With a single list, its items show directly in the sidebar; with more than one, each list gets its own heading and count.

Adding issues#

Open the issue browser, select one or more issues, and choose Add to to-do from the action bar. If you keep more than one list, you pick which one; adding the same issue twice is a no-op. Issues you've added are marked in the browser, and you can filter the browser to On a to-do list to see only the ones you've curated.

Adding free-text tasks#

Open the To-do manager with the gear button in the section header, then type a task into the Add a task field and press Enter. The manager is also where you rename and reorder lists, reorder items by dragging, and see completed items.

Starting work from a task#

Click a free-text task (or its Start work button in the manager) to open the Start work dialog. From there you:

• Edit the prompt sent to the agent (it starts as the task's text).
• Set the branch name (Tegment derives one from the task until you change it) and the base branch.
• Choose the agent and, if it supports it, turn on auto-approve.

Then either create a worktree for the task or run in an existing worktree. Tegment starts the agent with your prompt, and the task shows an In progress badge and moves to the top of the list.

Completing and removing items#

The sidebar shows only open items. Mark an item done from its checkbox in the To-do manager, where completed items collect under a Done section. To remove an item, hover its row and use the trash button, in the sidebar or the manager.

An issue-backed item marks itself done automatically when its issue closes on GitHub or Jira. If you un-complete such an item by hand afterwards, Tegment respects that and won't re-complete it.

Showing and hiding the sidebar#

Control when the To-do section appears under Settings → General → To-do list in sidebar: