atv 0.1.2

atv(async task viewer): a TUI tool for experimenting with Python 3.14 asyncio ps/pstree features

atv 🌱

atv(async task viewer) is a CLI for exploring Python asyncio processes with a Textual UI. It starts by listing Python processes running locally, and we plan to integrate execution of asyncio ps / pstree and call-graph visualization.

Setup

cd atv
uv sync

uv sync installs the specified dependencies (textual, psutil) into your local environment.

Usage

uv run atv

Shortcuts:

• R – Refresh the process list (the table shows PID / Process / File / Command Line)
• Q – Exit
• Enter / P – Run python -m asyncio ps for the selected PID and display the result in the right pane

Using uvx

Once released, you'll be able to launch it with a one-liner.

uvx atv

If you want to test uvx behavior during local development, run the following in the project root.

uvx --from . atv

Roadmap

• View that periodically runs python -m asyncio ps for the selected process
• Visualization for asyncio pstree / format_call_graph
• Snapshot capture and diff comparison
• Integration with the FastAPI demo (retrieve task information via the API)

License

This project is licensed under the MIT License. See LICENSE for details.