app.example.yml

# app.example.yml — Annotated app.yaml template for Claw
#
# Copy this file to app.yaml and fill in your values.
# app.yaml is gitignored since it contains deployment-specific configuration.
#
# Resource names (app, database, volume) are parameterized via the `name_prefix`
# bundle variable in databricks.yml (default: "claw"). To deploy with a custom
# prefix (e.g. to avoid collisions in a shared workspace):
#
#   databricks bundle deploy --var name_prefix=yourname
#
# Or run the /initial-setup skill which auto-detects your username and writes
# a local .databricks/bundle/dev.yml override so you never need --var manually.
#
# See https://docs.databricks.com/en/dev-tools/databricks-apps/app-runtime.html

command:
  - "sh"
  - "-c"
  - "uvicorn claw.main:app --host 0.0.0.0 --port ${DATABRICKS_APP_PORT:-8000}"

env:
  # -----------------------------------------------------------------
  # Required
  # -----------------------------------------------------------------

  # User's Personal Access Token — injected securely via valueFrom
  # referencing the "user-pat" secret resource defined in resources/app.yml
  - name: DATABRICKS_USER_PAT
    valueFrom: user-pat

  # Claude Agent SDK env vars — passed directly to the bundled CLI.
  # ANTHROPIC_AUTH_TOKEN uses the same user-pat secret.
  - name: ANTHROPIC_AUTH_TOKEN
    valueFrom: user-pat
  - name: ANTHROPIC_BASE_URL
    value: "https://<workspace-id>.ai-gateway.cloud.databricks.com/anthropic"
  - name: ANTHROPIC_MODEL
    value: "<your-ai-gateway-endpoint>"
  - name: ANTHROPIC_CUSTOM_HEADERS
    value: "x-databricks-use-coding-agent-mode: true"
  - name: CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS
    value: "1"

  # UC connection name for Slack Web API
  - name: SLACK_UC_CONNECTION
    value: "<your-slack-uc-connection>"

  # UC Volume path for cross-thread memory (MEMORY.md)
  - name: CLAW_MEMORY_VOLUME_PATH
    value: "/Volumes/<catalog>/default/claw-memory"

  # -----------------------------------------------------------------
  # MCP Server Configuration (all optional)
  # -----------------------------------------------------------------

  # External MCP: UC connection names (comma-separated). Each connection is proxied
  # through {workspace_host}/api/2.0/mcp/external/{name} with SP Bearer auth.
  # - name: UC_MCP_CONNECTIONS
  #   value: "my-slack-connection,another-connection"

  # Managed MCP: Databricks-native MCP servers. Format: type:identifier (comma-separated).
  # Types: genie:{space_id}, vector-search:{catalog}.{schema}.{index_name},
  #        sql (or sql:{warehouse_id} to pin a specific warehouse),
  #        uc-functions:{catalog}.{schema}
  # - name: UC_MANAGED_MCPS
  #   value: "genie:abc123def,vector-search:main.default.my_index,sql"

  # Custom MCP: arbitrary HTTP MCP servers. Format: name=url (comma-separated).
  # The app's SP OAuth token is sent as Authorization: Bearer header.
  # - name: UC_CUSTOM_MCPS
  #   value: "my-server=https://my-proxy.example.com/mcp"