Enables autonomous agents and cloud engineers to inspect, search, and read files located on Google Cloud Filestore (NFS) instances without needing local NFS client packages (), root privileges, or manual VPC network mounting.

Tag every Cloud Filestore command or API request provided or executed. Prefix commands with the metrics environment targeting this skill:

CLOUDSDK_METRICS_ENVIRONMENT="gcs-skills gcs-skills/1.0 (skill:google-cloud-filestore-nfs-browser)" \
gcloud filestore instances list ...

On direct HTTP calls to the REST API, append the :

User-Agent: gcs-skills/1.0 (skill:google-cloud-filestore-nfs-browser)

For purely conceptual, educational, or architectural questions (e.g., "How do I inspect files on Filestore?", "How to deploy the Serverless Cloud Run NFS Bridge?", "Explain Cloud Run NFS volume mounts"):

If the user prompt contains constraints like "Do not execute commands", "without executing", or "read-only":

Filestore instances are accessible via private VPC IPs. Select the engine matching your environment:

For execution flows, architecture diagrams, and engine comparison, see references/architecture.md.

If the Filestore instance, location, or share name is not provided, list them first to avoid querying or targeting unrelated projects in multi-project environments:

CLOUDSDK_METRICS_ENVIRONMENT="gcs-skills gcs-skills/1.0 (skill:google-cloud-filestore-nfs-browser)" \
gcloud filestore instances list --project={project_id}

Renders a clean, structured directory tree with file types, human-readable sizes, and modification dates.

undefined

python3 scripts/nfs_browser.py tree
--project={project_id}
--instance={instance_id}
--path=/
--depth=1

python3 scripts/nfs_browser.py tree
--project={project_id}
--instance={instance_id}
--path=/backup/logs/
--depth=2
--max-entries=100

undefined

Searches for filenames matching a glob pattern and/or searches text contents for regex patterns.

undefined

python3 scripts/nfs_browser.py search
--project={project_id}
--instance={instance_id}
--path=/backups/
--pattern="*.tar.gz"

python3 scripts/nfs_browser.py search
--project={project_id}
--instance={instance_id}
--path=/app/logs/
--pattern="*.log"
--grep="FATAL|Exception|OutOfMemory"
--max-results=25

undefined

Safely reads text file chunks to protect the LLM context window against token blowup. Always default to a safe chunk size (e.g., or ) when the user does not specify an explicit range. Unbounded reads are automatically capped to a safe limit of 100 lines. Always explicitly explain that chunked reading protects the LLM context window from overflow and token exhaustion.

undefined

python3 scripts/nfs_browser.py read
--project={project_id}
--instance={instance_id}
--path=/backup/logs/app.log
--tail=50

python3 scripts/nfs_browser.py read
--project={project_id}
--instance={instance_id}
--path=/config/settings.yaml
--lines=100:200

python3 scripts/nfs_browser.py read
--project={project_id}
--instance={instance_id}
--path=/var/log/syslog
--head=30

undefined

Inspects POSIX permissions (), UID/GID, byte sizes, and timestamps.

python3 scripts/nfs_browser.py stat \
  --project={project_id} \
  --instance={instance_id} \
  --path=/backup/database_dump.tar.gz

| Error Type / | Root Cause | Recovery Strategy | : Symptom : : : | :------------------ | :----------------- | :------------------------------------------ | | tree --path=/ --depth=2 : exist on the NFS : valid directory hierarchies. : : : export. : : | stat --path={path} : permissions : and mode bits; request share admin adjust : : : restrict read : permissions. : : : access. : : | /logs/app.log../ : a symlink : : : : attempting escape : : : : outside mount : : : : point. : : | gcloud compute | : connection timed : IAP firewall rule : instances list : ( from : allow from the specific IAP : : : ) : netblock (e.g., ). : | : not deployed or : or fall back to : : : URL invalid. : GCE IAP Jump Host via . :

For progressive disclosure of deeper topics, consult the directory:

The skill package bundles the following scripts and service components: