Skip to main content

​
Setup

  1. Mount Airstore to a local directory:
airstore mount ~/airstore
  1. Navigate to the mount point and start Claude:
cd ~/airstore
claude
Claude can read your smart folders and run tools from here.

​
Working with smart folders

Smart folders appear as directories containing files. Ask Claude to work with them:
  • “Summarize the invoices in the gmail/invoices folder”
  • “Review the PRs in github/open-prs and flag any security issues”
  • “Find action items in the contracts folder”
Claude reads the files and responds based on their contents.

​
Using tools

Tools are executables in the /tools directory. Claude can run them to take actions:
  • “Create a GitHub issue for the bug we just discussed”
  • “Send a Slack message to the team about the deployment”
Tools output JSON, which Claude can parse and act on.

​
Example prompts

Here are prompts that work well with Airstore data: 
# Summarize PRs touching a specific area
claude "Find PRs in github/open-prs that modify authentication code and summarize them"

# Process emails and take action
claude "Read gmail/invoices, extract amounts over $1000, and list them as a table"

# Cross-reference multiple sources
claude "Check linear/bugs for issues mentioned in github/open-prs"

​
Tips

​
Be specific about folders

Tell Claude which folder to look in: “Check the gmail/investor-emails folder for any requests I haven’t responded to”

​
Combine reading and actions

Claude can read data and then take action: “Find overdue invoices in gmail/invoices and draft reminder emails”

​
Use for repetitive tasks

Airstore works well for tasks you do regularly:
  • Weekly PR reviews
  • Invoice processing
  • Email triage
  • Contract analysis

​
Automate with the TypeScript SDK

If you’re building a product that pairs Claude Code with Airstore, you can provision everything programmatically using the SDK. This is useful when you want to set up workspaces, connect integrations, and create smart folders for users automatically — so Claude has data ready to go without any manual setup. 
import Airstore from '@airstore/sdk'

const airstore = new Airstore()

// Provision a workspace for a user
const ws = await airstore.workspaces.create({ name: `user-${userId}` })

// Connect their GitHub
await airstore.connections.create(ws.external_id, {
  integrationType: 'github',
  accessToken: userGithubToken,
})

// Set up smart folders for common tasks
await airstore.smartFolders.create(ws.external_id, {
  integration: 'github',
  name: 'Open PRs',
  guidance: 'open pull requests that need review',
})

// Generate a mount token for their machine
const { token } = await airstore.tokens.create(ws.external_id, {
  name: 'claude-workstation',
})

// They can now mount and use Claude:
// airstore mount ~/airstore --token <token> && cd ~/airstore && claude
See the TypeScript SDK docs for the full guide.

​
Limitations

  • Claude can only access data in your mounted smart folders
  • Large files may be truncated based on Claude’s context limits
  • Real-time data requires a fresh sync

​
Learn more

Smart Folders

Create folders with the data you need.

Tools

Take actions with MCP tools.

TypeScript SDK

Automate Airstore setup from your backend.

CLI Reference

Full mount and start command docs.