Tickets & Capacity

memvid tickets sync <FILE> --memory-id <ID> [OPTIONS]

# Sync with dashboard memory
memvid tickets sync project.mv2 --memory-id mem_abc123

# With environment API key
MEMVID_API_KEY=mv_live_xxx memvid tickets sync project.mv2 --memory-id mem_abc123

Syncing tickets for project.mv2...

Memory ID: mem_abc123
Memory Name: Production Memory

Ticket applied:
  Issuer: memvid.com
  Sequence: 43 (was: 42)
  Capacity: 1 GB
  Expires in: 30d

Binding status:
  Already bound: yes

Sync complete.

{
  "success": true,
  "memory_id": "mem_abc123",
  "already_bound": true,
  "ticket": {
    "issuer": "memvid.com",
    "seq_no": 43,
    "capacity_bytes": 1073741824,
    "expires_in_secs": 2592000
  }
}

memvid tickets apply <FILE> --memory-id <ID> [OPTIONS]

# Apply ticket from API
memvid tickets apply project.mv2 --memory-id mem_abc123 --from-api

memvid tickets issue <FILE> [OPTIONS]

# Issue enterprise ticket
memvid tickets issue project.mv2 \
  --issuer "enterprise.example.com" \
  --seq 1 \
  --expires-in 31536000 \
  --capacity 10737418240

memvid tickets list <FILE> [OPTIONS]

memvid tickets list project.mv2

Ticket for project.mv2

Status: ACTIVE

Ticket Details:
  Issuer: memvid.com
  Sequence: 43
  Capacity: 1 GB
  Expires: 2024-02-20T10:30:00Z (30d remaining)

Usage:
  Current size: 125.6 MB
  Capacity: 1 GB
  Available: 898.4 MB
  Usage: 12.2%

{
  "path": "project.mv2",
  "active": true,
  "ticket": {
    "issuer": "memvid.com",
    "seq_no": 43,
    "capacity_bytes": 1073741824,
    "expires_at": "2024-02-20T10:30:00Z",
    "expires_in_secs": 2592000
  },
  "usage": {
    "current_bytes": 131691315,
    "capacity_bytes": 1073741824,
    "available_bytes": 942050509,
    "usage_percent": 12.2
  }
}

memvid tickets revoke <FILE> [OPTIONS]

memvid tickets revoke project.mv2

memvid plan show [OPTIONS]

memvid plan show

Memvid Plan

Plan: Developer
Status: Active

Limits:
  Memories: 10 / 25
  Total capacity: 2.5 GB / 10 GB
  API calls: 45,231 / 100,000 (monthly)

Features:
  - Semantic search: included
  - LLM enrichment: included
  - Table extraction: included
  - Encryption: included
  - Priority support: not included

Billing:
  Next renewal: 2024-02-01
  Amount: $29/month

Upgrade: https://memvid.com/dashboard/plan

{
  "plan": "developer",
  "status": "active",
  "limits": {
    "memories": {"used": 10, "limit": 25},
    "capacity_bytes": {"used": 2684354560, "limit": 10737418240},
    "api_calls": {"used": 45231, "limit": 100000, "period": "monthly"}
  },
  "features": {
    "semantic_search": true,
    "llm_enrichment": true,
    "table_extraction": true,
    "encryption": true,
    "priority_support": false
  },
  "billing": {
    "next_renewal": "2024-02-01",
    "amount_cents": 2900,
    "currency": "usd"
  }
}

memvid plan sync [OPTIONS]

MEMVID_API_KEY=mv_live_xxx memvid plan sync

memvid plan clear [OPTIONS]

memvid bind knowledge.mv2 --memory-id YOUR_MEMORY_ID

memvid unbind knowledge.mv2

# 1. Create memory file
memvid create project.mv2

# 2. Sync with dashboard (binds and applies ticket)
MEMVID_API_KEY=mv_live_xxx memvid tickets sync project.mv2 --memory-id mem_abc123

# 3. Verify binding
memvid binding project.mv2

# Check current usage
memvid tickets list project.mv2

# Check plan limits
memvid plan show

# Script to alert on low capacity
USAGE=$(memvid tickets list project.mv2 --json | jq '.usage.usage_percent')
if (( $(echo "$USAGE > 80" | bc -l) )); then
  echo "Warning: Memory at ${USAGE}% capacity"
fi

# Tickets are refreshed automatically on sync
memvid tickets sync project.mv2 --memory-id mem_abc123

# Force refresh (re-fetch from API)
memvid tickets apply project.mv2 --memory-id mem_abc123 --from-api

# Issue tickets with your own signing key
memvid tickets issue project.mv2 \
  --issuer "internal.company.com" \
  --seq 1 \
  --expires-in 31536000 \
  --capacity 107374182400  # 100 GB

# Verify ticket
memvid tickets list project.mv2

# Estimate storage needs
# ~1 MB per 1000 documents (text only)
# ~10 MB per 1000 documents (with embeddings)
# ~50 MB per 1000 documents (with PDFs)

# Check current size
memvid stats project.mv2 --json | jq '.size_bytes'

# Project growth
# size_per_doc * docs_per_month * months

# Set API key globally
export MEMVID_API_KEY=mv_live_xxx

# Then sync without --api-key flag
memvid tickets sync knowledge.mv2 --memory-id abc-123

Error: CapacityExceeded: Memory file exceeded capacity limit

# Check your API key is set
echo $MEMVID_API_KEY

# Verify memory ID is correct
memvid tickets list knowledge.mv2

# Try with explicit API key
MEMVID_API_KEY=mv_live_xxx memvid tickets sync knowledge.mv2 --memory-id YOUR_ID

# Re-sync to get fresh ticket
memvid tickets sync knowledge.mv2 --memory-id YOUR_ID