config.toml

.amika/config.toml lives at the root of a Git repository and declares sandbox defaults for that repository. This page is a compact lookup of every key.

For concepts, examples, validation rules, and merge semantics, see the full guides: How configuration works (precedence, multi-repo, repo-less) and the config.toml reference (field-by-field spec).

The open-source amika CLI parses only [lifecycle].setup_script and [services.<name>]. The remaining sections are applied by the hosted platform. The singular [service.<name>] is accepted as an alias for [services.<name>].

`[lifecycle]`

Setup and start scripts. See details.

Key	Type	Default	Summary
`setup_script`	string (path)	no-op	Executable run once before the container command starts. Overridable with `--setup-script`.
`start_script`	string (path)	no-op	Executable run each time a stopped sandbox is restarted (hosted only).

`[env]`

Environment variables set inside the sandbox. See details and env vars vs. secrets.

Value form	Syntax	Summary
Plain string	`KEY = "value"`	Set as-is.
Secret reference	`KEY = { secret = "name" }`	Resolved from the vault at create time.
Service reference	`KEY = { service = "name", field = "url" \| "host" \| "port" }`	Injects a service’s URL, host, or port.

Names must be UPPER_SNAKE_CASE. DB entries override TOML entries per key.

`[services.<name>]`

Named services with port bindings. See details and Services.

Key	Type	Summary
`port`	integer or `"port/protocol"`	Single port (mutually exclusive with `ports`).
`ports`	array of integer or `"port/protocol"`	Multiple ports (mutually exclusive with `port`).
`url_scheme`	`"http"` / `"https"`, or array of `{ port, scheme }`	URL generation. Multi-port services must use the array form.

Ports 60899–60999 are reserved. Service definitions are DB-wins-all.

`[sandbox]`

Default sandbox settings. See details.

Key	Type	Default	Values
`preset`	string	`"coder"`	`"coder"`, `"coder-dind"`
`size`	string	`"m"`	`"xs"`, `"m"`, `"l"`, `"xl"`
`snapshot`	string	none	Friendly snapshot label (not the org-qualified name).

`[filesystem]`

Additional repos to clone alongside the primary repo. See details. Only the primary repo’s .amika/config.toml is applied — see multi-repo sandboxes.

`repos`

Type	Default	Summary
array of GitHub repo URLs	empty	Cloned at their default branch into `~/workspace/<repo-name>`. DB-wins-all.

`[agent_credentials]`

Per-agent default credential (TOML only, no database layer). See details.

Field	Type	Summary
`type`	`"api_key"` or `"oauth"`	Credential type to use.
`name`	string	Name of the credential to select.

Keys are agent kinds (claude, codex); unknown kinds are ignored.

How configuration works — resolution precedence and application
config.toml reference — full field-by-field spec
Repository configuration — reference-tab overview
Services — service runtime behavior

CLI and platform

Repository configuration

HTTP API

`[lifecycle]`

`[env]`

`[services.<name>]`

`[sandbox]`

`[filesystem]`

`repos`

`[agent_credentials]`

​[lifecycle]

​[env]

​[services.<name>]

​[sandbox]

​[filesystem]

​repos

​[agent_credentials]

​Related docs

`[lifecycle]`

`[env]`

`[services.<name>]`

`[sandbox]`

`[filesystem]`

`repos`

`[agent_credentials]`

Related docs