General
What is Airstore?
Airstore is a virtual filesystem that connects your data sources (Gmail, GitHub, Drive, etc.) and makes them accessible as files. You describe what you need in natural language, and Airstore materializes the results. The primary use case is running Claude Code on non-coding tasks by giving it the right context.Is Airstore open source?
Yes. Airstore is fully open source under the MIT license. You can self-host it or use the hosted version. View on GitHub →How is Airstore different from MCP?
MCP (Model Context Protocol) defines how agents interact with tools and resources. Airstore uses MCP under the hood but adds:- Smart folders: Natural language queries that materialize as files
- Unified filesystem: All sources appear as a single mounted directory
- Caching: Materialized views for fast reads
- Permissions: Hide folders and disable tools
Does Airstore work with agents other than Claude Code?
Yes. Any agent that can read a filesystem works with Airstore:- Claude Code
- Cursor
- Windsurf
- Custom agents
- Shell scripts
cat a file, it can use Airstore.
Performance
How fast is Airstore?
Reads are local-speed because they hit cached materialized views, not live APIs. The cache syncs periodically in the background.| Operation | Speed |
|---|---|
| File read | Milliseconds (cached) |
| Directory listing | Milliseconds (cached) |
| Smart folder sync | Seconds to minutes (depends on query) |
| Tool execution | Depends on target API |
Can I force a sync?
Yes. Smart folders sync periodically, but you can force immediate sync:Does Airstore handle rate limits?
Yes. Airstore manages rate limiting and retries for all source APIs. You don’t need to worry about hitting API limits.Data & Security
Where is my data stored?
- Hosted version: Encrypted at rest in Airstore’s infrastructure
- Self-hosted: Your own S3-compatible storage
Can I write back to sources?
Sources are read-only. To write (send emails, create issues, etc.), use tools:How do I control what agents can access?
Two mechanisms:-
Hide folders: Agents can’t see hidden folders
-
Disable tools: Agents can’t use disabled tools
Is there an audit log?
Yes. Every file read and tool call is logged:Sources
What sources are supported?
Currently:- Gmail
- Google Drive
- GitHub
- Linear
- Notion
- Slack
- Any MCP server (custom)
Can I add custom sources?
Yes. Add any MCP server:Why can’t I query everything?
Smart folder queries depend on what the source API supports. For example:- Gmail supports: sender, date, labels, attachments
- Gmail doesn’t support: email body full-text search (API limitation)
Deployment
What platforms are supported?
| Platform | Status |
|---|---|
| macOS (Apple Silicon) | Supported |
| macOS (Intel) | Supported |
| Linux (x86_64) | Supported |
| Linux (ARM64) | Supported |
| Windows | Coming soon |
Can I use Airstore in cloud sandboxes?
Yes. Generate a token and mount in any cloud environment:Can multiple machines share the same Airstore?
Yes. Mount from multiple machines using tokens. All mounts see the same sources and smart folders, with changes syncing periodically.How do I self-host?
See the self-hosting guide. Basic setup:Troubleshooting
Where do I report bugs?
GitHub IssuesHow do I get help?
- Check Common Issues
- Run diagnostics:
airstore doctor - File an issue on GitHub