# ContextFS Configuration
# Copy to .env and modify as needed
# =============================================================================
# STORAGE BACKEND SELECTION
# =============================================================================
# Options: sqlite (default), postgres, sqlite+falkordb, postgres+falkordb
# - sqlite: Local SQLite + ChromaDB (default, zero config)
# - postgres: PostgreSQL with pgvector + Apache AGE (unified)
# - sqlite+falkordb: SQLite + ChromaDB + FalkorDB graph
# - postgres+falkordb: PostgreSQL + FalkorDB graph
CONTEXTFS_BACKEND=sqlite
# =============================================================================
# DATA DIRECTORY (for sqlite/chromadb backends)
# =============================================================================
CONTEXTFS_DATA_DIR=~/.contextfs
# =============================================================================
# SQLITE CONFIGURATION
# =============================================================================
# Database filename (relative to DATA_DIR)
CONTEXTFS_SQLITE_FILENAME=context.db
# =============================================================================
# POSTGRESQL CONFIGURATION
# =============================================================================
# Connection string format: postgresql://user:password@host:port/database
CONTEXTFS_POSTGRES_URL=postgresql://contextfs:contextfs@localhost:5432/contextfs
# Enable pgvector extension for semantic search
CONTEXTFS_POSTGRES_PGVECTOR=true
# Enable Apache AGE extension for graph operations
CONTEXTFS_POSTGRES_AGE=true
# =============================================================================
# CHROMADB CONFIGURATION
# =============================================================================
# Embedding model for semantic search
CONTEXTFS_EMBEDDING_MODEL=all-MiniLM-L6-v2
# Embedding backend: auto (fastembed if installed, else sentence_transformers),
# fastembed (ONNX, faster), or sentence_transformers
CONTEXTFS_EMBEDDING_BACKEND=auto
# GPU acceleration: true, false, or empty for auto-detect
# Auto-detect enables CoreML on Apple Silicon (M1/M2/M3), CPU elsewhere
CONTEXTFS_USE_GPU=
# Parallel workers for embedding (empty = auto)
CONTEXTFS_EMBEDDING_PARALLEL_WORKERS=
# Embedding batch size (default: 256, larger = faster but more memory)
CONTEXTFS_EMBEDDING_BATCH_SIZE=256
# ChromaDB collection name
CONTEXTFS_CHROMA_COLLECTION=contextfs_memories
# ChromaDB server mode (optional, for remote ChromaDB)
# Leave empty for embedded mode
CONTEXTFS_CHROMA_HOST=
CONTEXTFS_CHROMA_PORT=8000
# =============================================================================
# FALKORDB CONFIGURATION (Graph Backend)
# =============================================================================
# Enable FalkorDB for advanced graph operations
CONTEXTFS_FALKORDB_ENABLED=false
# FalkorDB connection settings
CONTEXTFS_FALKORDB_HOST=localhost
CONTEXTFS_FALKORDB_PORT=6379
CONTEXTFS_FALKORDB_PASSWORD=
CONTEXTFS_FALKORDB_GRAPH_NAME=contextfs_memory
# =============================================================================
# MEMORY LINEAGE SETTINGS
# =============================================================================
# Enable automatic lineage tracking on memory updates
CONTEXTFS_LINEAGE_AUTO_TRACK=true
# Default merge strategy: union, intersection, latest, oldest
CONTEXTFS_LINEAGE_MERGE_STRATEGY=union
# Preserve tags when evolving memories
CONTEXTFS_LINEAGE_PRESERVE_TAGS=true
# =============================================================================
# SEARCH SETTINGS
# =============================================================================
# Default number of search results
CONTEXTFS_DEFAULT_SEARCH_LIMIT=10
# Minimum similarity score for semantic search (0.0-1.0)
CONTEXTFS_MIN_SIMILARITY_SCORE=0.3
# =============================================================================
# INDEXING SETTINGS
# =============================================================================
# Maximum git commits to index per repo (0 = unlimited)
CONTEXTFS_MAX_COMMITS=100
# =============================================================================
# SESSION SETTINGS
# =============================================================================
# Auto-save sessions on exit
CONTEXTFS_AUTO_SAVE_SESSIONS=true
# Session timeout in minutes
CONTEXTFS_SESSION_TIMEOUT_MINUTES=60
# Maximum concurrent login sessions per user per session type (Web, CLI, OAuth)
# When limit is exceeded, oldest session is removed (LRU policy)
CONTEXTFS_MAX_SESSIONS=10
# =============================================================================
# API KEYS (Optional - for LLM-powered features)
# =============================================================================
CONTEXTFS_ANTHROPIC_API_KEY=
CONTEXTFS_OPENAI_API_KEY=
# Default AI model for summaries: claude or openai
CONTEXTFS_DEFAULT_AI_MODEL=claude
CONTEXTFS_CLAUDE_MODEL=claude-3-sonnet-20240229
CONTEXTFS_OPENAI_MODEL=gpt-3.5-turbo
# =============================================================================
# MCP SERVER SETTINGS
# =============================================================================
# Enable MCP server
CONTEXTFS_MCP_ENABLED=true
# MCP server port (SSE transport)
CONTEXTFS_MCP_PORT=8003
# =============================================================================
# LOGGING
# =============================================================================
# Log level: DEBUG, INFO, WARNING, ERROR
CONTEXTFS_LOG_LEVEL=INFO
# Log file (empty for stdout only)
CONTEXTFS_LOG_FILE=
# =============================================================================
# CLOUD SYNC SERVICE
# =============================================================================
# OAuth credentials for web frontend
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
# OAuth credentials for CLI (separate OAuth apps with localhost callback)
CONTEXTFS_CLI_GITHUB_CLIENT_ID=
CONTEXTFS_CLI_GITHUB_CLIENT_SECRET=
CONTEXTFS_CLI_GOOGLE_CLIENT_ID=
CONTEXTFS_CLI_GOOGLE_CLIENT_SECRET=
CONTEXTFS_CLI_OAUTH_PORT=8400
# Stripe (for billing)
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=
STRIPE_PRICE_PRO=
STRIPE_PRICE_TEAM=
# Email service (Mailgun)
MAILGUN_API_KEY=
MAILGUN_DOMAIN=appmail.magnetonlabs.com
# App URLs
APP_BASE_URL=http://localhost:3000
# =============================================================================
# DEVELOPMENT / TESTING
# =============================================================================
# Enable debug mode
CONTEXTFS_DEBUG=false
# Test mode (uses in-memory databases)
CONTEXTFS_TEST_MODE=false
# =============================================================================
# NPM PUBLISHING (for maintainers)
# =============================================================================
# NPM token for publishing claude-plugin-contextfs package
# Create at: https://www.npmjs.com/settings/tokens
# Required permissions: Read and write, with "Bypass 2FA for automation"
NPM_TOKEN=
# =============================================================================
# SLACK NOTIFICATIONS (for maintainers)
# =============================================================================
# Slack incoming webhook URL for release notifications
# Create at: https://api.slack.com/apps → Your App → Incoming Webhooks
SLACK_WEBHOOK_URL=
