Files
archie/config.example.toml
T

148 lines
5.9 KiB
TOML

# archied configuration. Copy to ~/.config/archie/config.toml.
# Secrets are NOT configured here directly: each one is a {engine, key}
# reference resolved through a secrets engine at startup. The built-in
# "env" engine reads key as an environment variable name. Custom engines
# (sops, bws, vault/openbao, ...) are Yaegi plugins loaded from a
# directory -- see internal/secret.
# work_dir = "~/.local/share/archie/work" # default
# db_path = "~/.local/share/archie/archie.db"
poll_interval = "60s"
label = "archie"
bot_user = "vectis-labs-archie"
diff_cap_lines = 400
# max_retries = 3 # how many times a parked task is retried before permanent park (global default; set per-repo to override)
[forge]
type = "github"
host = "https://github.com"
token = { engine = "env", key = "ARCHIE_GITHUB_TOKEN" }
[dispatch]
trigger = "assignee" # "assignee", "label", or "either"
ack_reaction = "eyes" # "off" disables pickup reactions
[dispatch.labels]
queued = "archie:queued"
working = "archie:working"
waiting = "archie:waiting"
pr = "archie:pr"
parked = "archie:parked"
# dead = "archie:dead" # applied when a task exhausts max_retries
[models] # role -> ai-sdk runtime ref (used by agent workflows, Phase 4b)
triage = "openai/gpt-5.4"
planner = "openai/gpt-5.4"
builder = "openai/gpt-5.4"
[providers.openai]
class = "openai"
api_key_env = "OPENAI_API_KEY"
[providers.ollama]
class = "ollama"
# Optional interactive-chat catalog. /provider groups these references by
# their first path segment, and /model shows only the selected provider's
# entries. When omitted, Archie uses the distinct refs in [models].
#
# `operator` is the display name of the person this deployment assists. It is
# passed to the chat agent as runtime metadata, which means it is sent to the
# configured model provider on every turn -- leave it unset to tell the agent
# nothing about who is running it.
#
# `workspace` roots the chat agent's file and shell tools (read, write, edit,
# shell, grep, find). Unset, those tools are not registered at all. Set it and
# the agent can read, modify and execute inside that directory with the same
# reach the daemon process has -- choose it deliberately.
#
# `max_steps` caps the model/tool round-trips in a single chat turn
# (default 100). This is a task budget, not a safety limit: one question
# about a codebase easily costs a read, several greps and a few edits, and
# a turn that runs out stops mid-task looking like it gave up. To interrupt
# a turn, send /stop -- that cancels it immediately and clears anything
# queued behind it.
# [chat]
# operator = "Ada Lovelace"
# workspace = "~/.local/share/archie/workspace"
# max_steps = 100
# models = [
# "openai/gpt-5.6-sol",
# "openrouter/openai/gpt-5.6-sol",
# ]
# Optional self-hosted update adapter. Both values are argv arrays (never
# shell snippets). The check command must write a releaseupdate.Snapshot JSON
# document to stdout; configure the installer as well to show Approve/Defer.
# [chat.telegram]
# update_check_command = ["/usr/local/bin/archie-update-check"]
# update_install_command = ["/usr/local/bin/archie-update-install"]
# External MCP tools are launched and managed by Archie's MCP client.
# [[tools.mcp_servers]]
# name = "desktop-commander"
# transport = "stdio"
# command = "npx"
# args = ["-y", "@wonderwhy-er/desktop-commander@0.2.46", "--no-onboarding"]
# work_dir = "/path/to/workspace"
[agent]
mode = "inprocess" # "subprocess" runs each stage through archie-agent (stdin/stdout); "nats" sends stages over NATS
command = "archie-agent" # executable path for subprocess mode (not used in nats mode)
# Subprocess mode isolates the protocol and process lifecycle, not OS privileges.
# The worker still runs as the daemon user until the Docker sandbox phase lands.
# env = ["GOCACHE"] # extra environment variable names forwarded to the worker
[indexing] # workspace codesearch index; both paths default under work_dir
# index_dir = "/var/lib/archie/indexes" # codesearch sidecar files
# db_path = "/var/lib/archie/workspace-indexes.db" # index lifecycle metadata
[web] # observability dashboard (read-only, no auth -- keep it local/tailnet)
listen = "127.0.0.1:8484" # "off" disables
[notify] # optional webhook for human-in-the-loop moments (n8n -> email)
# webhook = "https://n8n.example.com/webhook/archie"
[budgets]
max_steps = 60
max_tokens = 400000
wall_clock = "30m"
gate_max_failures = 5
# NATS JetStream for distributed task queue. Remove or leave commented out
# to run in single-process SQLite mode.
# [nats]
# url = "nats://localhost:4222"
# token_env = "NATS_TOKEN" # optional; named variable must be set
# Docker sandbox execution of archie-agent. Requires [nats] and agent.mode = "nats".
# [containers]
# enabled = true
# image = "archie-agent:latest" # Docker image to run
# max_concurrency = 4 # max simultaneous tasks/containers
# max_uptime = "60m" # container lifetime cap
# volume_ttl = "72h" # max age for persistent repo volumes and Git clone caches
# pull_policy = "missing" # "missing" or "always"
[[repos]]
owner = "samcharles93"
name = "todo"
base = "main"
ecosystem = "go" # "go", "python", "node", "rust", or "custom"
# Override the ecosystem defaults when needed:
# preflight = [["go", "version"]]
# test_glob = "*_test.go"
protect = ["_templ.go"]
gate = [
["templ", "generate", "./components/"],
["go", "vet", "./..."],
["go", "build", "./..."],
["golangci-lint", "run"],
["go", "test", "./...", "-count=1"],
]
# allow_concurrent = true # let the daemon run multiple tasks for this repo at once instead of
# FIFO-serializing them; only safe when concurrent worktrees won't collide
# (e.g. different base branches or packages per task). Still bounded by
# [containers].max_concurrency globally.
# persistent_storage = true # reuse a per-repo Docker volume and Git object cache until volume_ttl