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.

Atv

Install / Use

README