Store Management

Stores transform any data into AI-native search engines that understand meaning, not just keywords. They act as containers for your files, automatically generating embeddings and enabling advanced search capabilities. Use these commands to create, manage, and organize your stores. Learn more about stores in the documentation.

List Stores

Command

mxbai store list [options]

Options

--filter <name> - Filter by name pattern
--limit <n> - Limit number of results

Examples

# List all stores
mxbai store list

# Filter stores by name
mxbai store list --filter "docs"

# Limit results
mxbai store list --limit 5

Create Store

Command

mxbai store create <name> [options]

Options

--description <desc> - Description for the store
--expires-after <days> - Auto-delete after specified days
--metadata <json> - JSON metadata for the store

Examples

# Create a basic store
mxbai store create "my-knowledge-base"

# Create with description
mxbai store create "my-knowledge-base" --description "Project documentation"

# Create with expiration
mxbai store create "Temp Store" --expires-after 30

# Create with metadata
mxbai store create "Project Store" --metadata '{"project": "web-app", "team": "engineering"}'

Get Store Details

Command

mxbai store get <name-or-id>

Options

None

Examples

# Get store by name
mxbai store get "my-knowledge-base"

# Get store by ID
mxbai store get "my-knowledge-base"

Update Store

Command

mxbai store update <name-or-id> [options]

Options

--name <name> - New name for the store
--description <desc> - New description
--expires-after <days> - Update expiration
--metadata <json> - Update metadata

Examples

# Update description
mxbai store update "my-knowledge-base" --description "Updated description"

# Rename store
mxbai store update "Old Name" --name "New Name"

# Update metadata
mxbai store update "My Store" --metadata '{"version": "2.0"}'

Delete Store

Command

mxbai store delete <name-or-id> [options]

Alias: mxbai store rm <name-or-id>

Options

--yes, -y - Skip confirmation prompt

Examples

# Delete with confirmation prompt
mxbai store delete "my-knowledge-base"

# Delete without confirmation
mxbai store delete "my-knowledge-base" --yes

# Delete using alias
mxbai store rm "my-knowledge-base" --yes

# Delete by ID
mxbai store delete "my-knowledge-base" --yes

Store Management

On this page