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.