foxctl-core

name	foxctl-core
description	Core foxctl workflow for safe file work, fast repo search, and running skills with structured, low-friction commands.

What I do

• Give you a small, reliable “toolbelt” for everyday work (fs + search + run).
• Prefer structured tools over ad-hoc shell.

When to use me

• You want to inspect or change files safely.
• You need to find where something lives, fast.
• You want to run an foxctl skill but aren’t sure which one.

Quick start

1) Run any skill

foxctl run <skill> --input '<json>'

2) File operations

foxctl run fs/ls   --input '{"path": ".", "all": true, "long": true}'
foxctl run fs/read --input '{"path": "README.md"}'
foxctl run fs/write --input '{"path": "out.txt", "content": "...", "mode": "overwrite"}'
foxctl run fs/tree --input '{"path": ".", "max_depth": 3, "gitignore": true}'
foxctl run fs/find --input '{"path": ".", "pattern": "*.go", "type": "file"}'

3) Search

Use text/grep for fast literal search and code/context_grep when you want whole functions/blocks.

foxctl run text/grep --input '{"pattern": "PathValidator", "path": "."}'
foxctl run code/context_grep --input '{"pattern": "PathValidator", "path": ".", "expand_functions": true}'

4) JSON plumbing

foxctl run data/jq --input '{"query": ".data", "input": "<json>"}'
foxctl run json/transform --input '{"operation": "extract", "path": ".data", "input": "<json>"}'