axio-tools-local
Core filesystem and shell tool handlers for axio.
Gives your agent the ability to read, write, and patch files, run shell commands, execute Python snippets, and browse directory trees - the essential toolkit for a coding assistant.
Tools
| Function | Entry point | Description |
|---|---|---|
shell |
shell |
Run any shell command with configurable timeout, cwd, and stdin |
run_python |
run_python |
Execute a Python snippet in a subprocess |
read_file |
read_file |
Read a file, optionally with line range |
write_file |
write_file |
Write or overwrite a file |
patch_file |
patch_file |
Replace a range of lines in an existing file (1-indexed, both ends inclusive) |
list_files |
list_files |
List files in a directory |
Installation
pip install axio-tools-local
Usage
Standalone (without TUI)
from axio.agent import Agent
from axio.context import MemoryContextStore
from axio_transport_openai import OpenAITransport, OPENAI_MODELS
from axio_tools_local.shell import shell
from axio_tools_local.read_file import read_file
from axio_tools_local.write_file import write_file
from axio_tools_local.list_files import list_files
from axio.tool import Tool
tools = [
Tool(name="shell", handler=shell),
Tool(name="read_file", handler=read_file),
Tool(name="write_file", handler=write_file),
Tool(name="list_files", handler=list_files),
]
agent = Agent(
system="You are a coding assistant with access to the local filesystem.",
tools=tools,
transport=OpenAITransport(api_key="sk-...", model=OPENAI_MODELS["gpt-4o"]),
)
Via plugin (with axio-tui)
pip install "axio-tui[local]"
uv run axio # shell, read_file, write_file, patch_file, list_files, run_python appear automatically
Tool details
shell
import asyncio
from axio_tools_local.shell import shell
asyncio.run(shell(command="echo hello", cwd=".", timeout=30))
asyncio.run(shell(command="cat", stdin="hello"))
Parameters: command: str, timeout: int = 5, cwd: str = ".", stdin: str | None = None
patch_file
Replaces a range of lines in an existing file - safe for surgical edits without
rewriting the whole file. Lines are 1-indexed and both from_line and to_line
are inclusive. To insert without deleting any existing lines, set
to_line = from_line - 1. Always read the file first with line_numbers=True to
get correct line numbers.
import asyncio
import tempfile, os
from axio_tools_local.patch_file import patch_file
with tempfile.NamedTemporaryFile(mode="w", suffix=".py", delete=False) as f:
f.write("line1\nline2\nline3\n")
name = f.name
# Replace line 2
asyncio.run(patch_file(file_path=name, from_line=2, to_line=2, content="replaced\n"))
os.unlink(name)
Parameters: file_path: str, from_line: int, to_line: int, content: str, mode: int = 0o644
list_files
import asyncio
from axio_tools_local.list_files import list_files
asyncio.run(list_files(directory="."))
run_python
import asyncio
from axio_tools_local.run_python import run_python
asyncio.run(run_python(code="import sys; print(sys.version)"))
Plugin registration
[project.entry-points."axio.tools"]
shell = "axio_tools_local.shell:shell"
run_python = "axio_tools_local.run_python:run_python"
write_file = "axio_tools_local.write_file:write_file"
patch_file = "axio_tools_local.patch_file:patch_file"
read_file = "axio_tools_local.read_file:read_file"
list_files = "axio_tools_local.list_files:list_files"
Part of the axio ecosystem
axio · axio-tools-mcp · axio-tools-docker · axio-tui
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for axio-tools-local 0.11.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| axio_tools_local-0.11.1.tar.gz | 43.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| axio_tools_local-0.11.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 54.7 kB
Release files / axio_tools_local-0.11.1.tar.gz
| Download URL | axio_tools_local-0.11.1.tar.gz |
|---|---|
| Size | 43.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6619023e750c49b7138e497cf21698e831db598a2079a4a76df4fdceb0ab147d
|
|
BLAKE2b-256 checksum How to use checksums |
a890075a1b700eebe24b5f71d8e5a93348dd1ff538c00fd4db33474b8b5c066f
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 29, 2026.
Transparency logRelease files / axio_tools_local-0.11.1-py3-none-any.whl
| Download URL | axio_tools_local-0.11.1-py3-none-any.whl |
|---|---|
| Size | 11.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3416b9687caba4c502c94ba945929d3578b3f6c8f6f44c9c0beba0605356cc34
|
|
BLAKE2b-256 checksum How to use checksums |
a6bc3328ff594565f431263f035ad577696abe3dea6825d74cb7ea6f257caf51
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 29, 2026.
Transparency log
