Copied to clipboard

tapes

tapes config

Manage persistent configuration stored in .tapes/config.toml. Config values provide defaults for command flags.

Usage

# Set a value
tapes config set proxy.provider anthropic

# Get a value
tapes config get proxy.provider

# List all values
tapes config list

Subcommands

Command Description
tapes config set <key> <value> Set a configuration value
tapes config get <key> Get a configuration value
tapes config list List all configuration values

Config Keys

Key Description
storage.sqlite_path SQLite database path
proxy.provider LLM provider (ollama, openai, anthropic)
proxy.upstream Upstream LLM provider URL
proxy.listen Proxy server listen address
api.listen API server listen address
client.proxy_target Proxy URL for client commands (chat, etc.)
client.api_target API URL for client commands (search, etc.)
vector_store.provider Vector store type (sqlite, chroma, qdrant, pgvector)
vector_store.target Vector store URL or filepath
embedding.provider Embedding provider (ollama, openai)
embedding.target Embedding service URL
embedding.model Embedding model name
embedding.dimensions Embedding vector dimensions
opencode.provider Default LLM provider for opencode (anthropic, openai, ollama)
opencode.model Default model for opencode
proxy.project Project name to tag sessions (auto-detected from git if not set)
telemetry.disabled Disable anonymous usage telemetry (default: false)
update.disabled Disable automatic update checking at startup

Precedence

Configuration values are resolved in this order (highest to lowest priority):

  1. CLI flags — Always override everything
  2. Environment variables — TAPES_* prefixed variables
  3. Config file — Values set in config.toml
  4. Defaults — Built-in default values

Environment Variables

Every config key can be set via environment variable with the TAPES_ prefix. Replace dots with underscores and uppercase the key:

Config Key Environment Variable
proxy.listen TAPES_PROXY_LISTEN
proxy.provider TAPES_PROXY_PROVIDER
proxy.upstream TAPES_PROXY_UPSTREAM
proxy.project TAPES_PROXY_PROJECT
storage.sqlite_path TAPES_STORAGE_SQLITE_PATH
storage.postgres_dsn TAPES_STORAGE_POSTGRES_DSN
api.listen TAPES_API_LISTEN
embedding.provider TAPES_EMBEDDING_PROVIDER
embedding.target TAPES_EMBEDDING_TARGET
embedding.model TAPES_EMBEDDING_MODEL
telemetry.disabled TAPES_TELEMETRY_DISABLED
update.disabled TAPES_UPDATE_DISABLED

The pattern applies to all config keys: TAPES_ + key in uppercase with dots replaced by underscores.

Last updated: