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.10.1

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.10.1
File	Size	Uploaded
axio_tui-0.10.1.tar.gz	51.6 kB	Aug 26, 2026	Details

Built distribution (wheel)

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

Total release size: 95.2 kB

Release files / axio_tui-0.10.1.tar.gz

Download URL	axio_tui-0.10.1.tar.gz
Size	51.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`aaa97061bca419357479441038a0570912ad291222558950cd9bce569a34dd46`
BLAKE2b-256 checksum How to use checksums	`0ddebca60b01d73c843d2b703debe427902c6df776a6911fd66d76e8503d07c8`
Upload date	Aug 26, 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/aa3a7338c9d5362b50faeadc590edea297ab50fe

Workflow

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

Artifact

Subject: axio_tui-0.10.1.tar.gz
SHA-256 checksum: aaa97061bca419357479441038a0570912ad291222558950cd9bce569a34dd46 Verifying attestations

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

Download URL	axio_tui-0.10.1-py3-none-any.whl
Size	43.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d720a17191fcc94fdda0bf2e4c0e3c54575a18874795d04e060cd522792ecb7c`
BLAKE2b-256 checksum How to use checksums	`a00b83263ef8d6e96b4e1d186ef332d614d5497a2addf9f7c4b38caee0a6bf23`
Upload date	Aug 26, 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/aa3a7338c9d5362b50faeadc590edea297ab50fe

Workflow

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

Artifact

Subject: axio_tui-0.10.1-py3-none-any.whl
SHA-256 checksum: d720a17191fcc94fdda0bf2e4c0e3c54575a18874795d04e060cd522792ecb7c Verifying attestations