{"id":43414139,"url":"https://github.com/beam-cloud/airstore","last_synced_at":"2026-04-08T00:01:44.276Z","repository":{"id":334987008,"uuid":"1143618985","full_name":"beam-cloud/airstore","owner":"beam-cloud","description":"The filesystem for AI agents","archived":false,"fork":false,"pushed_at":"2026-03-07T23:32:24.000Z","size":86519,"stargazers_count":160,"open_issues_count":5,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-08T04:51:18.022Z","etag":null,"topics":["ai","claude-code","context","filesystem","fuse","llm","openclaw"],"latest_commit_sha":null,"homepage":"https://www.airstore.ai/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beam-cloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-27T19:58:18.000Z","updated_at":"2026-03-07T19:45:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/beam-cloud/airstore","commit_stats":null,"previous_names":["beam-cloud/airstore"],"tags_count":174,"template":false,"template_full_name":null,"purl":"pkg:github/beam-cloud/airstore","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beam-cloud%2Fairstore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beam-cloud%2Fairstore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beam-cloud%2Fairstore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beam-cloud%2Fairstore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beam-cloud","download_url":"https://codeload.github.com/beam-cloud/airstore/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beam-cloud%2Fairstore/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30448588,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-12T21:31:01.033Z","status":"ssl_error","status_checked_at":"2026-03-12T21:30:43.161Z","response_time":114,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude-code","context","filesystem","fuse","llm","openclaw"],"created_at":"2026-02-02T17:24:41.872Z","updated_at":"2026-03-12T23:02:48.558Z","avatar_url":"https://github.com/beam-cloud.png","language":"Go","readme":"# Airstore\n\n**The filesystem for AI agents**\n\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/beam-cloud/airstore)](https://github.com/beam-cloud/airstore/stargazers)\n\n[Website](https://airstore.ai) · [Docs](https://docs.airstore.ai) · [Demo Video](https://youtu.be/rWJo4wJe4wY) · [Discord](https://discord.gg/6y5UUsXpqt)\n\n---\n\n## What is Airstore?\n\nAirstore adds any source of data into a virtual filesystem. Connect Gmail, GitHub, Linear — then describe what you need in plain English. Results appear as files that Claude Code can read.\n\n⭐ If this is useful, [give us a star](https://github.com/beam-cloud/airstore)\n\n## Why files?\n\nClaude Code already knows how to read files, search directories, and work with file contents. By turning your integrations into files, Claude can use the same tools it uses for code, for your data.\n\nSource views also let you scope exactly what Claude can access. Instead of granting access to your entire inbox, create a view with just \"invoices from last week\" — or use structured filters for precise control.\n\n## Features\n\n- **Source views** - Natural language or structured queries that materialize as folders of files\n- **Integrations** - Connect GitHub, Gmail, Google Drive, Linear, Notion, Slack, Web\n- **Tools** - MCP servers exposed as executable binaries\n- **Team workspaces** - Share integrations and source views across your team\n- **Local mode** - Run entirely on your own infrastructure\n\n## Quick Start\n\n### 1. Sign up\n\nGo to [app.airstore.ai](https://app.airstore.ai) and create an account.\n\n### 2. Connect an Integration\n\nIn the dashboard, go to **Settings → Integrations** and connect a service (GitHub, Gmail, Drive, and more.).\n\n### 3. Create a source view\n\nClick **New Folder** and describe what you want in natural language, or use structured filters:\n\n- \"Open PRs in acme/api that need review\"\n- \"Invoices I received in email last week\"\n- \"High priority issues in the current sprint\"\n\n### 4. Install the CLI and Login\n\n```bash\ncurl -fsSL https://get.airstore.ai | sh\n```\n\n```\nairstore login\n```\n\n### 5. Mount the filesystem\n\n```bash\nairstore mount ~/airstore \n```\n\nYour source views are now available as local directories:\n\n```bash\nls ~/airstore/gmail/invoices/\n# stripe-invoice-jan-28.eml\n# aws-invoice-jan-25.eml\n# digitalocean-jan-22.eml\n```\n\n```bash\ncat ~/airstore/gmail/invoices/stripe-invoice-jan-28.eml\n\nFrom: billing@stripe.com\nSubject: Your invoice from Stripe\nDate: Jan 28, 2025\n\nAmount: $249.00\nStatus: Paid\n```\n\n### 6. Use with Claude Code\n\n```bash\ncd ~/airstore\nclaude\n```\n\nAsk Claude to work with your data:\n\n- \"Summarize these invoices and tell me the total\"\n- \"Which invoices are unpaid?\"\n- \"Extract vendor names and amounts into a CSV\"\n\n## How it works\n\n```\n~/airstore/\n├── linear/\n│   └── design-issues/     # Source view\n├── github/\n│   └── open-prs/          # Source view\n├── gmail/\n│   └── invoices/          # Source view\n└── tools/\n    ├── github             # MCP tool executable\n    ├── linear             # MCP tool executable\n    └── gmail              # MCP tool executable\n```\n\n**Source views** contain data from your integrations, materialized as files. They sync automatically in the background, or manually on demand.\n\n**Tools** are MCP servers exposed as executables that let you take actions:\n\n```bash\n~/airstore/tools/github create-issue --repo=acme/api --title=\"Bug fix needed\"\n```\n\nTools output JSON and can be piped together with standard Unix tools:\n\n```bash\n~/airstore/tools/wikipedia search \"albert\" | grep -i 'einstein'\n```\n\n## Installation\n\nThe install script handles everything:\n\n```bash\ncurl -fsSL https://get.airstore.ai | sh\n```\n\nThis automatically:\n- Downloads the correct binary for your platform (macOS/Linux, Intel/ARM)\n- Installs FUSE dependencies\n- Configures permissions\n\nVerify the installation:\n\n```bash\nairstore --version\n```\n\n### System requirements\n\n| Platform | Status |\n|----------|--------|\n| macOS (Apple Silicon) | Supported |\n| macOS (Intel) | Supported |\n| Linux (x86_64) | Supported |\n| Linux (ARM64) | Supported |\n| Windows | Coming soon |\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eLocal Mode (Self-Hosted)\u003c/strong\u003e\u003c/summary\u003e\n\nFor development or self-hosted deployments, you can run Airstore entirely on your own infrastructure with your own MCP servers.\n\n### Prerequisites\n\n**FUSE** (required):\n\n```bash\n# macOS\nbrew install fuse-t\n\n# Ubuntu/Debian\nsudo apt install fuse3\n```\n\n**Node.js** (for npx-based MCP servers):\n\n```bash\n# macOS\nbrew install node\n\n# Ubuntu/Debian\nsudo apt install nodejs npm\n```\n\n### Configuration\n\nCreate a `config.local.yaml` file:\n\n```yaml\nmode: local\n\ngateway:\n  grpc:\n    port: 1993\n  http:\n    host: 127.0.0.1\n    port: 1994\n\ntools:\n  mcp:\n    filesystem:\n      command: npx\n      args: [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"/tmp\", \"/Users\"]\n\n    memory:\n      command: npx\n      args: [\"-y\", \"@modelcontextprotocol/server-memory\"]\n\n    wikipedia:\n      command: npx\n      args: [\"-y\", \"@modelcontextprotocol/server-wikipedia\"]\n\n    github:\n      command: npx\n      args: [\"-y\", \"@modelcontextprotocol/server-github\"]\n      env:\n        GITHUB_TOKEN: \"${GITHUB_TOKEN}\"\n```\n\n### Mount locally\n\n```bash\nairstore mount ~/airstore --config config.local.yaml\n```\n\nYour tools are now available:\n\n```bash\nls ~/airstore/tools/\n# filesystem  memory  wikipedia  github\n\n# Search Wikipedia\n~/airstore/tools/wikipedia search \"artificial intelligence\"\n\n# List files\n~/airstore/tools/filesystem list_directory /tmp\n\n# Get help for any tool\n~/airstore/tools/filesystem --help\n```\n\n### Building from source\n\n```bash\ngit clone https://github.com/beam-cloud/airstore\ncd airstore\nmake build\n./bin/cli mount ~/airstore --config config.local.yaml\n```\n\n\u003c/details\u003e\n\n---\n\n## Documentation\n\nFull documentation at [docs.airstore.ai](https://docs.airstore.ai):\n\n- [Quickstart](https://docs.airstore.ai/quickstart) - Get running in 5 minutes\n- [Source Views](https://docs.airstore.ai/concepts/source-views) - Create dynamic data views\n- [Tools](https://docs.airstore.ai/concepts/tools) - Run MCP tools as CLI commands\n- [CLI Reference](https://docs.airstore.ai/reference/cli) - Full command documentation\n\n## Contributing\n\nPRs welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\nJoin our [Discord](https://discord.gg/6y5UUsXpqt) to discuss ideas and get help.\n\n## License\n\nAGPL 3.0 License - see [LICENSE](LICENSE) for details.\n","funding_links":[],"categories":["Skills \u0026 Plugins"],"sub_categories":["Third-Party Platforms"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeam-cloud%2Fairstore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeam-cloud%2Fairstore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeam-cloud%2Fairstore/lists"}