foxctl File System

What problem does it solve?

It helps you safely inspect and modify files inside your local repo without risky path handling, while still supporting efficient access to very large files.

Core Features & Use Cases

• Safe file operations: Read, write, list, and recursively view directory trees with predictable structure.
• Search and discovery: Find files by path and pattern to quickly locate code, configs, and assets.
• Large-file handling (CAS): Automatically stores oversized files in content-addressed storage and lets you retrieve them by artifact hash.
• Safety guardrails: Blocks unsafe path traversal attempts (such as ../) and symlink escape behavior to prevent unintended access.

Quick Start

Ask your agent to list files in the current directory in long format by running foxctl run fs/ls with input {"path":".","all":true,"long":true}.