axio-tui

Textual TUI application for axio.

A full-featured terminal chat interface with session management, a plugin system for transports and tools, and a built-in SQLite context store. Pick your LLM backend, load your tools, and start chatting - all from the terminal.

Features

Plugin system - transports, tools, and guards discovered automatically via entry points
Session management - persistent SQLite-backed conversations; fork, switch, and resume sessions
Streaming UI - text and tool calls rendered incrementally as they arrive
Multi-transport - switch between Anthropic, OpenAI, Nebius, Codex, or any registered backend at runtime
Sub-agent support - the subagent tool lets the agent spin up nested agent sessions
Vision - vision tool for image analysis (with compatible models)
Serveable - textual-serve support for browser-based access

Installation

Minimal (core TUI only, bring your own transport):

pip install axio-tui

With everything:

pip install "axio-tui[all]"

Pick what you need:

pip install "axio-tui[openai,local,mcp]"

Extra	Installs
`anthropic`	axio-transport-anthropic
`openai`	axio-transport-openai
`codex`	axio-transport-codex
`local`	axio-tools-local
`mcp`	axio-tools-mcp
`guards`	axio-tui-guards
`all`	Everything above

Quick start

pip install "axio-tui[openai,local]"
axio

On first launch, open Settings (s) to configure your API key and model. Sessions are stored in ~/.local/share/axio/.

Architecture

axio-tui
├── App (Textual)
│   ├── ChatScreen        - message list, input, streaming
│   ├── SessionScreen     - session list and management
│   └── SettingsScreen    - per-plugin configuration
├── SQLiteContextStore    - persistent conversation history
├── TransportRegistry     - discovers axio.transport entry points
└── Plugin system
    ├── ToolsPlugin       - wraps axio.tools.settings providers
    └── PermissionGuard   - wraps axio.guards providers

Built-in tools

These tools are always available regardless of installed plugins:

Tool	Description
`confirm`	Ask the user a yes/no question (for guard prompts)
`status_line`	Update the TUI status bar from within the agent
`subagent`	Spawn a nested agent with its own tools and context
`vision`	Analyse an image file (requires a vision-capable model)

Plugin entry points

axio-tui discovers plugins automatically when installed packages declare:

# Transport backend
[project.entry-points."axio.transport"]
openai = "axio_transport_openai:OpenAITransport"

# Tool group with settings screen
[project.entry-points."axio.tools.settings"]
docker = "axio_tools_docker.plugin:DockerPlugin"

# Simple tools (no settings)
[project.entry-points."axio.tools"]
shell = "axio_tools_local.shell:Shell"

# Permission guards
[project.entry-points."axio.guards"]
path = "axio_tui_guards.guards:PathGuard"

Serve over HTTP

textual-serve axio_tui.__main__:app
# Open http://localhost:8000 in your browser

Part of the axio ecosystem

axio · axio-transport-anthropic · axio-tui-guards · axio-tools-local · axio-tools-mcp · axio-tools-docker

License

MIT

Metadata

Release files for axio-tui 0.11.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for axio-tui 0.11.0
File	Size	Uploaded
axio_tui-0.11.0.tar.gz	55.0 kB	Aug 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for axio-tui 0.11.0
File	Interpreter	ABI	Platform	Reset
axio_tui-0.11.0-py3-none-any.whl 45.9 kB Aug 29, 2026	Python 3	none	any	Details

Total release size: 100.9 kB

Release files / axio_tui-0.11.0.tar.gz

Download URL	axio_tui-0.11.0.tar.gz
Size	55.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`52ec03005b938feb53766e2ef3721bd1caee00386e50af451c5300948bd2a8c5`
BLAKE2b-256 checksum How to use checksums	`0046db106a8f4df21ef8f938ac0f98ada7d8343dcbea1ac00583c1f52ad59739`
Upload date	Aug 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mosquito/axio-agent
Publishing commit: github.com/mosquito/axio-agent/tree/ce3585cec7563c547516e817c26efdac6773a776

Workflow

Publishing configuration: github.com/mosquito/axio-agent/blob/ce3585cec7563c547516e817c26efdac6773a776/.github/workflows/publish.yml
Publishing logs: github.com/mosquito/axio-agent/actions/runs/33267279677/attempts/1

Artifact

Subject: axio_tui-0.11.0.tar.gz
SHA-256 checksum: 52ec03005b938feb53766e2ef3721bd1caee00386e50af451c5300948bd2a8c5 Verifying attestations

Release files / axio_tui-0.11.0-py3-none-any.whl

Download URL	axio_tui-0.11.0-py3-none-any.whl
Size	45.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`df7c27cb8e1444889305ad98263f6956f3009f128f5c89e04dfe3463c0b30a4a`
BLAKE2b-256 checksum How to use checksums	`3b3a2f0a2bd47ed2a8ae084705eaad264355293148548e859b59160a58cd989e`
Upload date	Aug 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mosquito/axio-agent
Publishing commit: github.com/mosquito/axio-agent/tree/ce3585cec7563c547516e817c26efdac6773a776

Workflow

Publishing configuration: github.com/mosquito/axio-agent/blob/ce3585cec7563c547516e817c26efdac6773a776/.github/workflows/publish.yml
Publishing logs: github.com/mosquito/axio-agent/actions/runs/33267279677/attempts/1

Artifact

Subject: axio_tui-0.11.0-py3-none-any.whl
SHA-256 checksum: df7c27cb8e1444889305ad98263f6956f3009f128f5c89e04dfe3463c0b30a4a Verifying attestations