REFERENCE / CONFIG SCHEMA

Config schema

This is the exhaustive reference for promptLM configuration. For the narrative version (what to set first, what’s required) see Configuration.

Environment variables

The .env.example shipped at the repository root declares the variables the CLI and Studio expect.

Variable Required Purpose

Variable	Required	Purpose
`REPO_REMOTE_URL`	yes	Base URL of the Git host’s REST API endpoint (not the web UI). See Configuration § Environment variables for the host → endpoint table.
`REPO_REMOTE_USERNAME`	yes	Username or owner on the remote host.
`REPO_REMOTE_TOKEN`	yes	Personal access token with `repo` scope.
`OPENAI_API_KEY`	yes	Forwarded to Spring AI’s OpenAI client and the `watch.open-ai-api-key` binding.
`ANTHROPIC_API_KEY`	no	Forwarded to Spring AI’s Anthropic client when the model catalog routes to Claude.
`REPO_REMOTE_ALLOW_LOOPBACK_HOST_ALIASES`	no, default `true`	Permit loopback aliases when resolving the remote URL — useful for local Gitea setups.
`PROMPTLM_RELEASE_PROMOTION_MODE`	no, default `direct`	Picks the prompt-release promotion mode. See Releases § Promotion modes.

REPO_REMOTE_URL

yes

Base URL of the Git host’s REST API endpoint (not the web UI). See Configuration § Environment variables for the host → endpoint table.

REPO_REMOTE_USERNAME

yes

Username or owner on the remote host.

REPO_REMOTE_TOKEN

yes

Personal access token with repo scope.

OPENAI_API_KEY

yes

Forwarded to Spring AI’s OpenAI client and the watch.open-ai-api-key binding.

ANTHROPIC_API_KEY

Forwarded to Spring AI’s Anthropic client when the model catalog routes to Claude.

REPO_REMOTE_ALLOW_LOOPBACK_HOST_ALIASES

no, default true

Permit loopback aliases when resolving the remote URL — useful for local Gitea setups.

PROMPTLM_RELEASE_PROMOTION_MODE

no, default direct

Picks the prompt-release promotion mode. See Releases § Promotion modes.

`promptlm.*` properties

Spring properties read by the CLI and Studio.

Property Default Purpose

Property	Default	Purpose
`promptlm.release.promotion.mode`	`direct`	`direct` or `pr_two_phase`. See Releases.
`promptlm.store.local.workspace-root`	`${user.home}`	Local directory under which prompt stores are created.
`promptlm.store.remote.username`	`${REPO_REMOTE_USERNAME}`	Username for the remote store client.
`promptlm.store.remote.token`	`${REPO_REMOTE_TOKEN}`	Token for the remote store client.
`promptlm.store.remote.base-url`	`${REPO_REMOTE_URL}`	Remote host API base URL.
`promptlm.store.remote.allow-loopback-host-aliases`	`true`	Permit loopback aliases when resolving the remote URL.

promptlm.release.promotion.mode

direct

direct or pr_two_phase. See Releases.

promptlm.store.local.workspace-root

${user.home}

Local directory under which prompt stores are created.

promptlm.store.remote.username

${REPO_REMOTE_USERNAME}

Username for the remote store client.

promptlm.store.remote.token

${REPO_REMOTE_TOKEN}

Token for the remote store client.

promptlm.store.remote.base-url

${REPO_REMOTE_URL}

Remote host API base URL.

promptlm.store.remote.allow-loopback-host-aliases

true

Permit loopback aliases when resolving the remote URL.

`promptlm.gateway.litellm.*` properties

The LiteLLM gateway module is opt-in. Full property reference, including nested docker. and discovery. groups, is on LLM providers.

Spring AI properties

Property Reads from

Property	Reads from
`spring.ai.openai.api-key`	`OPENAI_API_KEY`
`spring.ai.anthropic.api-key`	`ANTHROPIC_API_KEY`

spring.ai.openai.api-key

OPENAI_API_KEY

spring.ai.anthropic.api-key

ANTHROPIC_API_KEY

Studio (`watch.*`) properties

The Studio runtime reads two polling intervals plus the OpenAI key binding.

Property Default Purpose

Property	Default	Purpose
`watch.api-polling-interval`	`10000` (ms)	How often Studio polls the API for project state.
`watch.dir-polling-interval`	`1000` (ms)	How often Studio polls the workspace directory.
`watch.open-ai-api-key`	`${OPENAI_API_KEY}`	Bound from the env var; used by the Studio runtime path.

watch.api-polling-interval

10000 (ms)

How often Studio polls the API for project state.

watch.dir-polling-interval

1000 (ms)

How often Studio polls the workspace directory.

watch.open-ai-api-key

${OPENAI_API_KEY}

Bound from the env var; used by the Studio runtime path.

Logging and management

logging.level.root defaults to warn for the CLI distribution. JVM metric binders are disabled by default for fast startup; re-enable per your operational needs.