agentfs-cli

Inspect bounded filesystem trees to generate machine-readable snapshots with configurable depth and hashes.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/SebastianBoehler/agent-cli-utils --skill agentfs-cli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentfs-cli
Source: https://github.com/SebastianBoehler/agent-cli-utils/tree/main/skills/agentfs-cli
Command: npx skills add https://github.com/SebastianBoehler/agent-cli-utils --skill agentfs-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inspectors need a lightweight, bounded view of a local filesystem to avoid expensive traversals and large outputs.

Core Features & Use Cases

  • Bounded depth and entry limits to keep snapshots cheap and deterministic.
  • Text previews and hash options to balance detail with performance.
  • Use Case: When debugging an agent, capture a snapshot of /etc or /var/log to feed automations without exposing the entire filesystem.

Quick Start

Run agentfs with a bounded root and depth to generate a portable, machine-readable snapshot.

Frequently Asked Questions about agentfs-cli

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

FAQPage Schema
How do I generate a lightweight filesystem snapshot for agent automation?▼

Generate a lightweight filesystem snapshot by running the CLI with a bounded root directory and depth limits. This produces a portable, machine-readable directory state without expensive traversals of large file trees.

Can I limit directory traversal depth and entry counts to avoid large outputs?▼

Yes, you can limit directory traversal depth and entry counts by configuring the max-depth and max-entries parameters. These bounded limits keep filesystem snapshots cheap, deterministic, and safely constrained in size.

Does the CLI support generating file previews and hashes during filesystem inspection?▼

The CLI supports generating file previews and hashes during filesystem inspection. You can configure preview-lines for text content previews and enable hashing options to balance inspection detail with performance overhead.

What is the best way to capture a bounded directory state for debugging agents?▼

The best way to capture a bounded directory state for debugging agents is running an automated filesystem inspection with configured depth, preview, and format parameters. This yields a machine-readable snapshot of target directories like /var/log.

What output formats are available for machine-readable filesystem snapshots?▼

Machine-readable filesystem snapshots are controlled by the format parameter. You specify the desired output format alongside depth, entry, preview, and hash settings to generate a portable snapshot tailored for agent consumption.