Configuration Directory

The CLI stores configuration in ~/.doclayer/:

~/.doclayer/
├── config.json      # Main configuration file
├── credentials      # Encrypted credentials (tokens, API keys)
└── profiles/        # Optional per-profile settings

Configuration File

The main configuration file config.json stores profiles and default settings:

{
  "default_profile": "production",
  "profiles": {
    "local": {
      "name": "local",
      "base_url": "http://localhost:8000",
      "tenant_id": null,
      "default_project": null,
      "output_format": "table"
    },
    "development": {
      "name": "development",
      "base_url": "https://dev-api.doclayer.ai",
      "tenant_id": "tenant_dev_123",
      "default_project": "proj_test",
      "output_format": "json"
    },
    "production": {
      "name": "production",
      "base_url": "https://api.doclayer.ai",
      "tenant_id": "tenant_prod_456",
      "default_project": "proj_main",
      "output_format": "table"
    }
  }
}

Working with Profiles

Profiles let you switch between different environments (local, dev, staging, production) easily:

# List all profiles
doclayer config profile list

# Create a new profile
doclayer config profile create staging

# Switch active profile
doclayer config profile use staging

# Edit profile settings
doclayer config profile edit staging

# Delete a profile
doclayer config profile delete staging

# Show current configuration
doclayer config show

# Import profiles from YAML file
doclayer config import-profiles --from-file profiles.yaml --force

# Set default profile
doclayer config import-profiles --from-file profiles.yaml --set-default local

Profile Import Format

# profiles.yaml
local:
  base_url: http://localhost:8000
  tenant_id: null
  default_project: null

development:
  base_url: https://dev-api.doclayer.ai
  tenant_id: tenant_dev_123
  default_project: proj_test

production:
  base_url: https://api.doclayer.ai
  tenant_id: tenant_prod_456
  default_project: proj_main

Using Profiles Per Command

# Use specific profile for a command
doclayer --profile production agent list

# Short form
doclayer -p staging ingest file doc.pdf --project proj_123

Environment Variables

Environment variables override configuration file settings:

Example Shell Configuration

# Add to ~/.bashrc or ~/.zshrc

# Authentication
export DOCLAYER_API_KEY="dly_your_api_key_here"
export DOCLAYER_TENANT="00000000-0000-0000-0000-000000000000"

# Default profile
export DOCLAYER_PROFILE="production"

# For pgvector verification (optional)
export DOCLAYER_PG_DSN="postgresql://user:password@postgres.doclayer-infra.svc.cluster.local:5432/doclayer"

Authentication Methods

The CLI supports multiple authentication methods:

doclayer auth login

# Set via environment variable (recommended)
export DOCLAYER_API_KEY="dly_your_api_key"

# Or login with API key
doclayer auth login --api-key

# Verify authentication
doclayer auth status

export DOCLAYER_TOKEN="eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."

Managing API Keys

# List your API keys
doclayer auth api-key list

# Create a new API key
doclayer auth api-key create --name "CI/CD Pipeline"

# Revoke an API key
doclayer auth api-key revoke <key_id>

Security Best Practices

Troubleshooting