ACE - Support FS

File system primitives for ACE path resolution and project root discovery. ACE Logo

Gem Version Ruby License: MIT

Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.

ace-support-fs provides reusable filesystem helpers for path expansion, root detection, and directory traversal. It handles the platform and context differences so packages like ace-support-config and ace-search can resolve paths safely from any working directory.

Use Cases

Resolve paths safely across subdirectories - use consistent path expansion for tools that move across project subdirectories, including protocol-aware path handling.

Detect workspace boundaries - infer project root from marker files without shell-specific assumptions, so ace-search and ace-support-config scope correctly.

Build config scans - discover and rank candidate configuration directories during resolution, supporting the cascade logic in ace-support-config.

Testing Contract

This package is fast-only in the ACE testing model.

  • Deterministic coverage lives under test/fast/.
  • This migration does not introduce test/feat/ or test/e2e/ for this package.

Run:

  • ace-test ace-support-fs
  • ace-test ace-support-fs all

Part of ACE