foxctl-core

What problem does it solve?

It solves the problem of safely inspecting, searching, and executing repo-local AI skills without relying on ad-hoc shell commands or guesswork about which skill to run.

Core Features & Use Cases

• Safe file work: Provides structured filesystem operations like listing, reading, writing, and generating directory trees with options such as gitignore-aware traversal.
• Fast repo search: Supports literal text grep and code-aware context search (e.g., finding whole functions/blocks) plus pattern-based discovery.
• Low-friction skill execution: Runs any foxctl skill using JSON envelope inputs so you can reliably perform search and structured transformations during development tasks.
• Example use case: You want to locate the implementation of a symbol in a large codebase, inspect the relevant files, then run the appropriate skill to extract context or transform JSON output for the next step.

Quick Start

Run fs/read to safely view the contents of a file you need to understand before deciding which skill to run.