.env.example

# Env Vars for Local Dev or Standalone Local Server (start.mjs)
#
# Most of these vars can be set in .claude/settings.json -> env section
# Common env vars to override in settings.json:
#   AGENTS_OBSERVE_PROJECT_SLUG - sets the default project slug & name for a project
#   AGENTS_OBSERVE_LOG_LEVEL - controls the log level for the local mcp and cli file logs, used for debugging
#   AGENTS_OBSERVE_LOCAL_DATA_ROOT - change the default location of where the local logs and sqlite database is stored

# Server
AGENTS_OBSERVE_SERVER_PORT=4981   # Port used by local dev & docker container
AGENTS_OBSERVE_LOG_LEVEL=debug    # debug | trace

AGENTS_OBSERVE_RUNTIME=docker     # docker | local

# Base dir where state data and sqlite database is saved on local host
# Defaults to CLAUDE_PLUGIN_DATA dir when running as a claude plugin
AGENTS_OBSERVE_LOCAL_DATA_ROOT=./data

# Local dir to bind mount into the docker container, defaults to $AGENTS_OBSERVE_LOCAL_DATA_ROOT/data
# AGENTS_OBSERVE_DATA_DIR=./data/db

# Location of local cli and mcp log files, defaults to $AGENTS_OBSERVE_LOCAL_DATA_ROOT/logs
# AGENTS_OBSERVE_LOGS_DIR=

# Plugin / CLI overrides (optional)
# AGENTS_OBSERVE_API_BASE_URL=http://127.0.0.1:4981/api   # Override API base URL used by observe_cli.mjs
# AGENTS_OBSERVE_DOCKER_CONTAINER_NAME=agents-observe     # Docker container name
# AGENTS_OBSERVE_DOCKER_IMAGE=ghcr.io/simple10/agents-observe:v1.0.0  # Docker image to pull/run; defaults to the same version as the plugin

# LOCAL DEV ONLY
# These are only relevant when running `just dev`
# In normal docker or standalone server modes, server process serves the client UI on the same port
AGENTS_OBSERVE_DEV_CLIENT_PORT=5174   # Vite dev server port for dashboard UI