CLI Reference - Airstore

Global options

These options work with all commands:

Option	Description
`--help`, `-h`	Show help for a command
`--version`, `-v`	Show version
`--config`	Path to config file
`--verbose`	Enable verbose output
`--quiet`, `-q`	Suppress non-error output

Authentication

Authenticate with Airstore.

airstore login

Opens your browser for OAuth authentication.

`airstore logout`

Log out and clear credentials.

airstore logout

`airstore whoami`

Show current authenticated user.

airstore whoami

Sources

`airstore connect <source>`

Connect a data source via OAuth.

airstore connect gmail
airstore connect github
airstore connect gdrive
airstore connect linear
airstore connect notion
airstore connect slack

Option	Description
`--reauth`	Force re-authentication

`airstore disconnect <source>`

Disconnect a source.

airstore disconnect gmail

`airstore sources list`

List connected sources.

airstore sources list

Smart folders

`airstore create <path> --query "<query>"`

Create a smart folder with a natural language query.

airstore create sources/gmail/investor-emails \
  --query "emails from investors in the last 30 days"

Option	Description
`--query`, `-q`	Natural language query (required)

`airstore update <path> --query "<query>"`

Update a smart folder’s query.

airstore update sources/gmail/investor-emails \
  --query "emails from investors in the last 60 days"

`airstore delete <path>`

Delete a smart folder.

airstore delete sources/gmail/investor-emails

`airstore sync <path>`

Force sync a smart folder.

airstore sync sources/gmail/investor-emails

Mounting

`airstore mount <path>`

Mount the Airstore filesystem.

airstore mount ~/airstore

Option	Description
`--token`	Authentication token (for cloud)
`--foreground`	Run in foreground
`--sources`	Comma-separated list of sources to mount
`--tools-readonly`	Mount tools in read-only mode

`airstore unmount <path>`

Unmount the filesystem.

airstore unmount ~/airstore

`airstore status`

Show mount status.

airstore status

MCP servers

`airstore mcp add`

Add a custom MCP server.

airstore mcp add \
  --name=my-server \
  --command="npx my-mcp-server" \
  --env="API_KEY=xxx"

Option	Description
`--name`	Server identifier (required)
`--command`	Command to start server (required)
`--env`	Environment variable (repeatable)
`--args`	Additional arguments

`airstore mcp remove <name>`

Remove an MCP server.

airstore mcp remove my-server

`airstore mcp list`

List configured MCP servers.

airstore mcp list

`airstore mcp test <name>`

Test an MCP server connection.

airstore mcp test my-server

Tools

`airstore tools list`

List available tools.

airstore tools list

Option	Description
`--verbose`	Show command-level status

`airstore tools enable <tool>`

Enable a tool.

airstore tools enable github

`airstore tools disable <tool>`

Disable a tool.

airstore tools disable github

Option	Description
`--command`	Disable specific command only

`airstore tools readonly`

Enable read-only mode for all tools.

airstore tools readonly
airstore tools readonly --off

Permissions

`airstore hide <path>`

Hide a folder from agents.

airstore hide sources/gmail/personal

Option	Description
`--temporary`	Hide for current session only

`airstore show <path>`

Show a hidden folder to agents.

airstore show sources/gmail/personal

`airstore hidden list`

List hidden folders.

airstore hidden list

Tokens

`airstore token create`

Create a mount token.

airstore token create --name="modal-sandbox"

Option	Description
`--name`	Token name (required)
`--readonly`	Create read-only token
`--sources`	Limit to specific sources
`--expires`	Token expiration (e.g., “24h”, “7d”)

`airstore token list`

List tokens.

airstore token list

`airstore token revoke <name>`

Revoke a token.

airstore token revoke modal-sandbox

Logs

`airstore logs`

View audit logs.

airstore logs

Option	Description
`--since`	Start time (e.g., “1 hour ago”)
`--until`	End time
`--type`	Filter by event type
`--path`	Filter by path pattern
`--agent`	Filter by agent
`--format`	Output format (text, json, csv)
`--follow`, `-f`	Follow log output

Configuration

`airstore config get <key>`

Get a config value.

airstore config get api_url

`airstore config set <key> <value>`

Set a config value.

airstore config set api_url https://api.airstore.dev

`airstore config list`

List all config values.

airstore config list

Getting Started

Core Concepts

Sources

Tools

Permissions

Deployment

Reference

Examples

Troubleshooting

​Global options

​Authentication

​airstore login

​airstore logout

​airstore whoami

​Sources

​airstore connect <source>

​airstore disconnect <source>

​airstore sources list

​Smart folders

​airstore create <path> --query "<query>"

​airstore update <path> --query "<query>"

​airstore delete <path>

​airstore sync <path>

​Mounting

​airstore mount <path>

​airstore unmount <path>

​airstore status

​MCP servers

​airstore mcp add

​airstore mcp remove <name>

​airstore mcp list

​airstore mcp test <name>

​Tools

​airstore tools list

​airstore tools enable <tool>

​airstore tools disable <tool>

​airstore tools readonly

​Permissions

​airstore hide <path>

​airstore show <path>

​airstore hidden list

​Tokens

​airstore token create

​airstore token list

​airstore token revoke <name>

​Logs

​airstore logs

​Configuration

​airstore config get <key>

​airstore config set <key> <value>

​airstore config list

​Next steps

Config file

Environment variables

Global options

Authentication

`airstore login`

`airstore logout`

`airstore whoami`

Sources

`airstore connect <source>`

`airstore disconnect <source>`

`airstore sources list`

Smart folders

`airstore create <path> --query "<query>"`

`airstore update <path> --query "<query>"`

`airstore delete <path>`

`airstore sync <path>`

Mounting

`airstore mount <path>`

`airstore unmount <path>`

`airstore status`

MCP servers

`airstore mcp add`

`airstore mcp remove <name>`

`airstore mcp list`

`airstore mcp test <name>`

Tools

`airstore tools list`

`airstore tools enable <tool>`

`airstore tools disable <tool>`

`airstore tools readonly`

Permissions

`airstore hide <path>`

`airstore show <path>`

`airstore hidden list`

Tokens

`airstore token create`

`airstore token list`

`airstore token revoke <name>`

Logs

`airstore logs`

Configuration

`airstore config get <key>`

`airstore config set <key> <value>`

`airstore config list`

Next steps