Skip to main content
Hide folders from agents to implement the principle of least privilege. Agents only see what they need.

Why hide folders

When you run Claude Code on your Airstore filesystem, it can read any file. You might want to:
  • Prevent access to sensitive emails
  • Hide personal documents from work agents
  • Restrict access to specific projects
Hidden folders still exist—you can access them directly—but agents won’t see them when browsing.

Hide a folder

airstore hide sources/gmail/personal
The folder is now hidden from agent view. When Claude lists directories, it won’t see personal/.

Using the dashboard

  1. Open the Airstore dashboard
  2. Navigate to the folder
  3. Right-click and select “Hide from agents”
The folder appears dimmed in your view but is invisible to agents.

Show a hidden folder

airstore show sources/gmail/personal
Or right-click in the dashboard and select “Show to agents”.

List hidden folders

airstore hidden list
Hidden folders:
  sources/gmail/personal
  sources/gdrive/tax-documents
  sources/github/secret-project

How it works

Hidden folders are filtered at the FUSE layer:
  1. Agent requests directory listing
  2. FUSE checks the hidden list
  3. Hidden folders are omitted from the response
  4. Agent sees only visible folders
You (the user) always see all folders. The hiding only affects agents.

Patterns and wildcards

Hide multiple folders with patterns:
# Hide all personal folders
airstore hide "sources/*/personal"

# Hide a specific pattern
airstore hide "sources/gmail/*-private"

Temporary hiding

Hide a folder for the current session only:
airstore hide sources/gmail/personal --temporary
The folder becomes visible again after unmounting.

Inheritance

Hiding a parent folder hides all children:
airstore hide sources/gmail
# Also hides sources/gmail/inbox, sources/gmail/sent, etc.
To hide a parent but show specific children:
airstore hide sources/gmail
airstore show sources/gmail/work-inbox

Verification

Check if a folder is hidden:
airstore status sources/gmail/personal
Path: sources/gmail/personal
Hidden: yes
Hidden by: user (manual)

Next steps