pyoverview 0.4.0

A two-pane terminal outline browser for Python modules.

pyoverview

pyoverview is a small terminal outline browser for Python files. It parses a module with Python's ast module and opens a two-pane TUI:

• left pane: classes, functions, async functions, and nested definitions
• right pane: syntax-highlighted source code on the terminal's default background, automatically scrolled to the selected symbol

Sections

Add module-level section comments to group the outline into larger chunks:

# region Configuration

DEFAULT_MODEL = "gpt-5"


def load_config():
    ...


# region Review Model

class Finding:
    ...


async def score_patch():
    ...

# %% Title cell comments are also supported:

# %% SFT

def sft_dataset():
    ...


# %% GRPO

def grpo_dataset():
    ...

pyoverview renders those comments as section nodes:

reviewer.py
  section: Configuration  L1
    function: load_config()  L6
  section: Review Model  L10
    class: Finding  L12
    async function: async score_patch()  L16

Only comments starting at the beginning of a line with # region , # %% , or #%% create sections. A section runs until the next section marker or the end of the file.

Install

uvx pyoverview path/to/module.py

If you are developing locally:

uv run pyoverview path/to/module.py

Keys

• Up / Down, k / j: move through the outline
• PageUp / PageDown: scroll code
• g / G: jump to first / last outline item
• Enter: center the selected symbol in the code pane
• r: reload the file from disk
• q: quit

Non-interactive Use

pyoverview --print path/to/module.py

This prints the outline without opening the TUI.