Metadata-Version: 2.4
Name: filesystem-tools
Version: 1.0.0
Summary: File system tools for AI agents - read, write, search, edit files with workspace security
Author: SpiderCode Team
License: MIT
Keywords: filesystem,tools,ai,agent,workspace
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# filesystem-tools

File system tools for AI agents. Provides safe workspace-constrained file operations.

## Quick Start

```python
from filesystem_tools import read_file, write_file, list_files

write_file("hello.txt", "Hello, World!")
print(read_file("hello.txt"))
print(list_files("."))
```

## Features

- Read/write/append/create/delete files
- Copy/move/rename files and directories
- List files and directory tree
- Find files by name or extension
- Edit files: replace text, insert/delete/replace lines
- File metadata (size, timestamps, type)
- Path existence check
- Automatic workspace security (all paths confined to `./workspace`)
- Audit logging to `workspace/logs/filesystem.log`
