PyCharm 2023.3 Help

TODO tool window

PyCharm constantly scans your project for comments in the source code that match specific TODO patterns and displays them in the TODO tool window.

The TODO tool window (View | Tool Windows | TODO) consists of the following tabs:

  • Project: Shows TODO items for the whole project.

  • Current File: Shows TODO items for the currently open file in the editor.

  • Scope Based: Shows TODO items for a certain scope, selected from the list.

  • Current Changelist: Shows TODO items in the active changelist (available only if version control integration is enabled).

Toolbar buttons

Icon

Tooltip and shortcut

Description

Previous TODO

Previous TODO Ctrl+Alt+Up

Select the previous TODO item in the list.

Next TODO

Next TODO Ctrl+Alt+Down

Select the next TODO item in the list.

Filter TODO Items

Filter TODO Items

Select a filter or open the TODO dialog where you can edit the list of TODO patterns and filters as necessary.

Navigate with Single Click

Navigate with Single Click

When this toggle is selected, you can click items to open items in the editor. Otherwise, you can locate items in the editor by double-clicking them or pressing F4.

Expand All Ctrl+NumPad +

Click this button to expand all nodes.

Collapse All Ctrl+NumPad -

Click this button to collapse all nodes.

View Options

Group by Project

Use this toggle to group TODO items by containing projects. Not available for the Current File tab.

Preview Source

Preview Source

Show a preview pane with the source code of the selected item in the corresponding file.

Context menu

Item

Description

Jump to Source F4

Jump to the location of the relevant comment in the source code. Available only when you right-click a TODO item or a file.

Local History

Show the Local History submenu:

  • Show History: Open the Local History window for the relevant file.

  • Put Label: Add a label to the Local History.

Last modified: 11 February 2024