foxctl File System

Perform safe local file read, write, list, and find operations with CAS retrieval.

3|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/joshka0/foxctl --skill foxctl-file-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foxctl File System
Source: https://github.com/joshka0/foxctl/tree/main/configs/skills-condensed/foxctl-fs
Command: npx skills add https://github.com/joshka0/foxctl --skill foxctl-file-system

SYSTEM DOCUMENTATION & REQUIREMENTS

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

Frequently Asked Questions about foxctl File System

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely read and write local files during repository navigation?

You can safely read and write local files by applying fs/read and fs/write operations with robust path safety, which blocks directory traversal attempts and symlink escape to ensure secure repository navigation.

What is the best way to handle large file retrieval in a local repository?

Large file handling uses content-addressed storage (CAS) to automatically store oversized files and retrieve them by artifact hash, ensuring efficient access to very large files during local repository exploration.

How do I find files by pattern and list directory trees locally?

You can discover files by running fs/find with path and pattern inputs, and use fs/ls and fs/tree to list directories and recursively view directory trees with predictable structure for quick code and config location.

Does safe file IO block path traversal and symlink escape attempts?

Yes, safe file IO includes safety guardrails that explicitly block unsafe path traversal attempts such as ../ and symlink escape behavior, preventing unintended access to files outside the target repository directory.

What are the limitations of pattern search when exploring local directories?

Pattern search via fs/find is limited to locating files by path and pattern within the local repository, and is constrained by safety guardrails that block any traversal attempts or symlink escapes outside the allowed directory scope.