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.
cd atv
uv sync
uv sync
installs the specified dependencies (textual
, psutil
) into your local environment.
uv run atv
Shortcuts:
R
– Refresh the process list (the table shows PID / Process / File / Command Line)Q
– ExitEnter
/P
– Runpython -m asyncio ps
for the selected PID and display the result in the right pane
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
- 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)
This project is licensed under the MIT License. See LICENSE
for details.