CLI Reference

The Airstore CLI provides commands for managing workspaces, members, connections, and tokens, as well as mounting the virtual filesystem.

Global flags

These flags work with all commands:

Flag	Description
`--gateway`	Gateway gRPC address (default: `gateway.airstore.ai:443`)
`--gateway-http`	Gateway HTTP address (default: `https://api.airstore.ai`)
`--token`	Authentication token
`--json`	Output in JSON format
`-h`, `--help`	Show help for a command
`-v`, `--version`	Show version

Authentication

Authenticate via browser. Opens your default browser to complete authentication. Usage: airstore login

airstore login

After successful login, credentials are stored in ~/.airstore/credentials and used automatically by other commands.

For CI/CD or automation, use airstore mount --token instead.

Workspaces

Manage workspaces. A workspace is a container for members, connections, and tasks.

`airstore workspace create`

Create a new workspace. Usage: airstore workspace create <name>

airstore workspace create my-workspace

`airstore workspace list`

List all workspaces.

airstore workspace list

`airstore workspace get`

Get workspace details. Usage: airstore workspace get <id>

airstore workspace get ws_abc123

`airstore workspace delete`

Delete a workspace. Usage: airstore workspace delete <id>

airstore workspace delete ws_abc123

Members

Manage workspace members.

`airstore member add`

Add a member to a workspace. Usage: airstore member add <workspace_id> <email>

airstore member add ws_abc123 user@example.com
airstore member add ws_abc123 user@example.com --name "Jane Doe" --role admin

Option	Description
`--name`	Member display name
`--role`	Role: `admin`, `member`, `viewer` (default: `member`)

`airstore member list`

List members in a workspace. Usage: airstore member list <workspace_id>

airstore member list ws_abc123

`airstore member remove`

Remove a member from a workspace. Usage: airstore member remove <member_id>

airstore member remove mem_xyz789

Connections

Manage integration connections. Connections link external services (GitHub, Gmail, etc.) to your workspace.

`airstore connection add`

Add an integration connection to a workspace. Usage: airstore connection add <workspace_id> <type> Supported integration types:

Type	Authentication	Description
`github`	`--token`	GitHub personal access token (`ghp_` or `github_pat_`)
`gmail`	`--token`	Gmail OAuth access token
`gdrive`	`--token`	Google Drive OAuth access token
`notion`	`--token`	Notion integration token (`secret_` or `ntn_`)
`weather`	`--api-key`	OpenWeatherMap API key
`exa`	`--api-key`	Exa AI search API key
`posthog`	`--api-key`	PostHog personal API key (`phx_*`)

# Token-based integrations
airstore connection add ws_abc123 github --token ghp_xxxxxxxxxxxx
airstore connection add ws_abc123 notion --token secret_xxxxxxxxxxxx

# API key integrations
airstore connection add ws_abc123 weather --api-key abc123
airstore connection add ws_abc123 exa --api-key abc123
airstore connection add ws_abc123 posthog --api-key phx_xxxxxxxxxxxx

# Personal connection (not shared with workspace)
airstore connection add ws_abc123 github --token ghp_xxx --member mem_xyz

Option	Description
`--token`	Access token (for OAuth integrations like GitHub, Gmail)
`--api-key`	API key (for API key integrations like Weather, Exa)
`--member`	Member ID for personal connection (omit for shared)
`--scope`	OAuth scopes

`airstore connection list`

List connections in a workspace. Usage: airstore connection list <workspace_id>

airstore connection list ws_abc123

`airstore connection remove`

Remove a connection. Usage: airstore connection remove <connection_id>

airstore connection remove conn_abc123

`airstore connection connect`

Connect an OAuth integration via browser. Opens a browser for authentication. Usage: airstore connection connect <integration>

airstore connection connect gmail
airstore connection connect gdrive

Supported OAuth integrations: gmail, gdrive

Requires authentication via airstore login or --token flag.

Mount

Mount the Airstore virtual filesystem.

`airstore mount`

Mount the Airstore virtual filesystem at the specified path. This command blocks until unmounted (Ctrl+C). Usage: airstore mount <path>

airstore mount ~/airstore --config config.local.yaml

The filesystem provides configured MCP tools as executables in /tools/*.

Option	Description
`--verbose`, `-v`	Enable verbose logging
`--config`, `-c`	Path to config file (required for local mode)
`--token`	API token for non-interactive auth (skips browser login)

Local mode runs an embedded gateway within the CLI process:

airstore mount ~/airstore --config config.local.yaml

After mounting, the command displays:

  airstore mounted

  Mount    ~/airstore
  Gateway  127.0.0.1:1993
  Mode     local

  Available paths:
    /tools/*        Tool binaries

  Press Ctrl+C to unmount

Press Ctrl+C to gracefully unmount. Press Ctrl+C again to force exit.

`airstore start`

Run Airstore as a background service with a menu bar app (macOS only). This is an alternative to airstore mount that doesn’t require keeping a terminal open. Usage: airstore start

airstore start

After starting, Airstore mounts to ~/Desktop/Airstore and an icon appears in your menu bar where you can unmount, open the folder, or quit.

On first run, macOS may prompt you to allow Airstore to run in the background.

Tokens

Manage workspace tokens. Tokens are used for authentication when mounting or accessing the API.

`airstore token create`

Create an API token for a member. Usage: airstore token create <workspace_id> <member_id>

airstore token create ws_abc123 mem_xyz789
airstore token create ws_abc123 mem_xyz789 --name "CI Token" --expires 7d

Option	Description
`--name`	Token name (default: “API Token”)
`--expires`	Expiration duration (e.g., `24h`, `7d`, `30d`)

Save the token immediately after creation. It won’t be shown again.

`airstore token list`

List tokens in a workspace. Usage: airstore token list <workspace_id>

airstore token list ws_abc123

`airstore token revoke`

Revoke a token. Usage: airstore token revoke <token_id>

airstore token revoke tok_abc123

Completion

Generate shell autocompletion scripts.

`airstore completion bash`

Generate bash completion script.

# Add to ~/.bashrc
source <(airstore completion bash)

`airstore completion zsh`

Generate zsh completion script.

# Add to ~/.zshrc
source <(airstore completion zsh)

`airstore completion fish`

Generate fish completion script.

airstore completion fish | source

`airstore completion powershell`

Generate PowerShell completion script.

airstore completion powershell | Out-String | Invoke-Expression

See also: Config file reference | Mounting

Getting Started

Core Concepts

Guides

Integration Guides

Self-Hosted / Local

Reference

Security

Global flags

Authentication

Workspaces

`airstore workspace create`

`airstore workspace list`

`airstore workspace get`

`airstore workspace delete`

Members

`airstore member add`

`airstore member list`

`airstore member remove`

Connections

`airstore connection add`

`airstore connection list`

`airstore connection remove`

`airstore connection connect`

Mount

`airstore mount`

`airstore start`

Tokens

`airstore token create`

`airstore token list`

`airstore token revoke`

Completion

`airstore completion bash`

`airstore completion zsh`

`airstore completion fish`

`airstore completion powershell`

​Global flags

​Authentication

​airstore login

​Workspaces

​airstore workspace create

​airstore workspace list

​airstore workspace get

​airstore workspace delete

​Members

​airstore member add

​airstore member list

​airstore member remove

​Connections

​airstore connection add

​airstore connection list

​airstore connection remove

​airstore connection connect

​Mount

​airstore mount

​airstore start

​Tokens

​airstore token create

​airstore token list

​airstore token revoke

​Completion

​airstore completion bash

​airstore completion zsh

​airstore completion fish

​airstore completion powershell

Global flags

Authentication

`airstore login`

Workspaces

`airstore workspace create`

`airstore workspace list`

`airstore workspace get`

`airstore workspace delete`

Members

`airstore member add`

`airstore member list`

`airstore member remove`

Connections

`airstore connection add`

`airstore connection list`

`airstore connection remove`

`airstore connection connect`

Mount

`airstore mount`

`airstore start`

Tokens

`airstore token create`

`airstore token list`

`airstore token revoke`

Completion

`airstore completion bash`

`airstore completion zsh`

`airstore completion fish`

`airstore completion powershell`