Docs Operation reference settings operations
settings operations#
2 operations. Generated from assets/operations.json; all areas.
settings.get#
Settings
Read configured tool locations and update settings.
Annotations: read-only, idempotent, open world.
Takes no arguments.
tomaccoctl call settings.get
settings.configure#
Set up toolchain
Configure SDK, JDK and executable paths without installing or running them, how updates behave, how many heavy jobs run at once, and the agent policy.
Annotations: writes, idempotent, open world.
| Argument | Type | Required | Default | Details |
|---|---|---|---|---|
android_sdk | string | non-empty; Absolute local filesystem path | ||
java_home | string | non-empty; Absolute local filesystem path | ||
android_ndk | string | non-empty; Absolute local filesystem path | ||
swift_android_sdk | string | Installed Swift Android SDK identifier | ||
executables | object | Tool name to absolute executable path | ||
updates | object | Update behaviour | ||
updates.mode | string | one of off, notify, auto; off: no request unless the user asks. notify: check once a day and tell the user. auto: also install when idle. | ||
updates.channel | string | one of stable, prerelease; stable (default): GitHub's latest release. prerelease: also releases GitHub marks as pre-releases. | ||
updates.token_file | string | Owner-only file with a GitHub token, for a private repository; empty removes it | ||
jobs | object | How many heavy jobs run at once; more wait as queued with a reason. 0 means no limit | ||
jobs.max_builds | integer | 0 to 64; Builds and deploys (project.execute, project.run except Flutter sessions, ios.flutter_build); 2 by default | ||
jobs.max_emulators | integer | 0 to 64; Android emulators started with android.avd_start, for as long as they run; no limit by default | ||
agent_policy | object | The agent policy, replacing the stored one ({} removes it): mcp, cli and clients name the policy for MCP servers, tomaccoctl call and MCP clients by name (full, no_destructive, read_only or one in policies); policies defines named ones (mode, allow, deny, writes roots or anywhere, write_roots); approval (destructive, timeout_seconds 5-30, without_desktop allow or deny, session); limits (jobs_per_session 0-64, inline_result_kib 1-16384); audit true or false. Refused over MCP and under a limiting policy |
tomaccoctl call settings.configure