Configuration

In the app

Setting	Where	What it does
Theme	Settings → Appearance	Dark or Light.
Live refresh	Settings → Appearance	How often running pages update: every 1, 2 or 5 seconds.
Agent model	Settings → Agent model	Base URL, model and API key of the language model for the agent.
Server	Settings → Server	Which verlet-agent the app talks to.
Scan paths, tags, default	Environments → Edit	Per-environment options.

Using a verlet-agent elsewhere

By default the app starts its own verlet-agent. Connect lets you point it at another one instead: Use this computer for the bundled one, or a Server URL such as http://127.0.0.1:8080. To use a verlet-agent on another machine, forward its port over SSH first:

ssh -L 8080:localhost:8080 user@host

verlet-agent has no login of its own and listens on 127.0.0.1 only; reach it through SSH, never by exposing the port.

verlet-agent environment variables

For running verlet-agent outside the desktop app.

Variable	Default	Meaning
VERLET_AGENT_PORT	8080	Port to listen on.
VERLET_AGENT_BIND	127.0.0.1	Address to listen on.
VERLET_AGENT_CACHE_DIRECTORY	~/.cache/verlet-agent	Where simulations, runs, versions and the documentation index live.
VERLET_AGENT_DATABASE	<cache>/verlet-agent.db	The SQLite database file.
VERLET_AGENT_SCAN_PATHS	none	Extra directories to scan for executables on every environment.
LAMMPS_ROOT_DIRECTORY	none	A LAMMPS source tree, for looking up sources.
VERLET_PROBE_EXECUTABLE_PATH	found on PATH	The verlet-probe binary on this computer.
VERLET_AGENT_AGENT_API_KEY	none	API key for the agent’s model, for headless installs.
VERLET_AGENT_AGENT_APP_URL, VERLET_AGENT_AGENT_APP_TITLE	none, verlet-ai	Attribution headers sent to OpenRouter.
VERLET_AGENT_KB_SYNC_ON_START	true	Update the documentation index from GitHub at start.
VERLET_AGENT_GITHUB_TOKEN	none	Raises GitHub’s limit of 60 requests an hour for the index updates.
VERLET_AGENT_BUILD_ROOT	~/.verlet	Where engine builds on this computer go.
VERLET_AGENT_SSH	ssh	The OpenSSH client to use.
VERLET_AGENT_CORS_ALLOWED_ORIGINS	the app’s origins	Browser origins allowed to call the API.
VERLET_AGENT_DEBUG_LEVEL	INFO	Log level of the agent’s model calls; DEBUG shows the prompts and replies.

Check a running verlet-agent with GET /v1/health and GET /v1/info.