Skip to content

GitLab MR review configuration ​

These settings belong to the GitLab connector. Process environment variables take precedence over a local .env file.

Connections ​

VariableDefaultPurpose
GITLAB_BASE_URLrequiredGitLab base URL
GITLAB_TOKENrequiredBot API token for publication and reviewer management. Not sent to the sandbox
ORPHEUS_BASE_URLrequiredOrpheus API base URL without /api/v1
ORPHEUS_API_KEYrequiredService Bearer key accepted by Orpheus
ORPHEUS_WEB_BASE_URLORPHEUS_BASE_URLPublic web base URL for session links
WORKFLOWS_DIRworkflowsDirectory of workflow files, relative to the process working directory unless absolute

Process and limits ​

VariableDefaultPurpose
APP_MODEprodprod or dev
LOG_LEVELerrorLog verbosity. Use info for operation diagnostics
HTTP_TIMEOUT_SECONDS30Timeout of an individual HTTP request
POLL_INTERVAL_SECONDS30GitLab polling interval
SHUTDOWN_TIMEOUT_SECONDS20Graceful shutdown budget
RUN_TIMEOUT_SECONDS3600Agent run timeout
HOOK_TIMEOUT_SECONDS300Session hook timeout
MAX_SESSION_REQUEST_BYTES1048576Maximum bytes per workflow file and assembled session request. Range: 1–16777216
RECONCILE_WORKER_COUNT4Concurrent reconciliation tasks. Range: 1–64
RECONCILE_QUEUE_CAPACITY128Reconciliation queue capacity. Range: 1–4096
MAX_CONCURRENT_REVIEWS4Concurrent reviews. Range: 1–1024. Constrained by Orpheus capacity as well

All *_SECONDS settings accept positive integer seconds. Base URLs must use HTTP or HTTPS without embedded credentials, query parameters or fragments. Repository cloning in the sandbox requires HTTPS.

Workflow fields ​

FieldDefaultPurpose
idrequiredStable unique workflow ID matching [a-z0-9][a-z0-9_-]{0,79}
project_idsomittedNonempty list of unique positive GitLab project IDs. Omit for the fallback
profilerequiredExisting Orpheus profile
modelprofileOptional model override
sandbox_templaterequiredExisting sandbox template
servicesrequiredExplicit list of unique service codes. [] is allowed
languageomittedLanguage tag, such as en, ru or pt-BR, for agent-authored text
notes.success / notes.failEnglish defaultsMarkdown templates for completion and failure notes. Each field is optional

A nonempty Markdown review policy is required below the YAML. It replaces the profile instructions. See examples and routing.

Note placeholders ​

PlaceholderValue
{{ .FindingsCount }}Confirmed finding count on success, including zero
{{ .Reason }}Public Orpheus error message when available, otherwise an allowlisted application failure description. Markdown, HTML and mentions are escaped.
{{ .SessionURL }}Public session URL on failure, or an empty string when unavailable

The public Orpheus error message can contain the original harness error and is visible to readers of the MR. To omit error text, set a custom notes.fail without {{ .Reason }}. The connector does not append raw connector errors or hook logs.

Functions, conditions and other expressions are not supported. Explicitly blank fields, unknown substitutions and templates that can render an empty note are rejected. language does not translate templates or failure reasons.

File validation ​

The connector reads regular UTF-8 .md files at the directory root. Subdirectories, hidden files, names beginning with # and other extensions are skipped. IDs must be unique, project routes must not overlap, and at most one fallback is allowed. Nonregular or non-UTF-8 .md files, unknown fields, invalid YAML, an empty directory or an oversized file prevent the entire service from starting.

Workflows are loaded at startup. See how to apply changes.