exoclaw-tools-workspace

File system, shell, and web tools implementing the exoclaw ToolBase protocol — read/write/edit files, list directories, execute shell commands, search the web, and fetch URLs.

Install

pip install exoclaw-tools-workspace

Usage

from pathlib import Path
from exoclaw_tools_workspace.filesystem import ReadFileTool, WriteFileTool, EditFileTool, ListDirTool
from exoclaw_tools_workspace.shell import ExecTool
from exoclaw_tools_workspace.web import WebSearchTool, WebFetchTool

workspace = Path("~/.nanobot/workspace").expanduser()

tools = [
    ReadFileTool(workspace=workspace),
    WriteFileTool(workspace=workspace),
    EditFileTool(workspace=workspace),
    ListDirTool(workspace=workspace),
    ExecTool(timeout=30, working_dir=str(workspace)),
    WebSearchTool(api_key="..."),   # Brave Search API key, or set BRAVE_API_KEY
    WebFetchTool(),
]

All tools accept an optional allowed_dir to restrict file operations to within a directory. ExecTool ships with a built-in deny-list of destructive shell patterns.

Release files for exoclaw-tools-workspace 0.7.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 exoclaw-tools-workspace 0.7.0
File	Size	Uploaded
exoclaw_tools_workspace-0.7.0.tar.gz	14.2 kB	Apr 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for exoclaw-tools-workspace 0.7.0
File	Interpreter	ABI	Platform	Reset
exoclaw_tools_workspace-0.7.0-py3-none-any.whl 17.2 kB Apr 28, 2026	Python 3	none	any	Details

Total release size: 31.4 kB

Release files / exoclaw_tools_workspace-0.7.0.tar.gz

Download URL	exoclaw_tools_workspace-0.7.0.tar.gz
Size	14.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`c8b9d237f126147c6558176f808d379729b074b8059d96286000b861b026e801`
BLAKE2b-256 checksum How to use checksums	`3403dc46562e44abd09e8a2c0aac126bf40097e08752b285de922afc1ed0fdff`
Upload date	Apr 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / exoclaw_tools_workspace-0.7.0-py3-none-any.whl

Download URL	exoclaw_tools_workspace-0.7.0-py3-none-any.whl
Size	17.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5e675b48719b25389f733ebf15864182094490af797aab1cb7886cf26b8d7bfd`
BLAKE2b-256 checksum How to use checksums	`2f5525304817449a2bbdb18a112c61680c95e6b5beeb2765fc345af672bcf602`
Upload date	Apr 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`