otty / apps

All apps/OpenCode

OpenCode

opencode

The open source coding agent, model-agnostic by design.

Runs as opencode|macOS, Linux, Windows|opencode.ai

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

OpenCode in your home directory Every rule on this page, by file

· opencode.json Sync

· AGENTS.md Sync

· plugins/ Sync

· commands/ Sync

· themes/ Sync

· skills/ Sync

· node_modules/ Exclude

· bun.lock Exclude

· package-lock.json Exclude

· tui.json Exclude

· opencode.json.tui-migration.bak Exclude

· log/ Exclude

· storage/ Exclude

· cache/ Exclude

· auth.json Never synced

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/opencode/otty.tomlThe file this page is generated from

id = "opencode"

name = "OpenCode"

homepage = "https://opencode.ai/docs/config/"

description = "The open source coding agent, model-agnostic by design."

icon = "theSVG:opencode"

executables = ["opencode"]

[dotfiles]

# https://opencode.ai/docs/config/ — the global config is

# $XDG_CONFIG_HOME/opencode/opencode.json, with plugins, commands, themes and

# skills alongside it. That variable, and not a hard-coded ~/.config, is

# [configHome].

paths = [

"[configHome]/opencode/opencode.json",

"[configHome]/opencode/AGENTS.md",

"[configHome]/opencode/plugins/",

"[configHome]/opencode/commands/",

"[configHome]/opencode/themes/",

"[configHome]/opencode/skills/",

]

# The plugin directory is a real npm project, so it carries a lockfile and a

# node_modules tree. Sessions, storage and logs live under XDG data, which is

# [xdgData] and not [dataHome]: that name is ~/Library/Application Support on

# macOS, and opencode writes to ~/.local/share there too. It honours the

# variable rather than hard-coding the default — running it with XDG_DATA_HOME

# set puts the opencode directory under that instead.

exclude = [

"[configHome]/opencode/node_modules/",

"[configHome]/opencode/bun.lock",

"[configHome]/opencode/package-lock.json",

"[configHome]/opencode/tui.json",

"[configHome]/opencode/opencode.json.tui-migration.bak",

"[xdgData]/opencode/log/",

"[xdgData]/opencode/storage/",

"[xdgData]/opencode/cache/",

]

# Mode 0600, holds the provider API keys and OAuth refresh tokens.

secret = ["[xdgData]/opencode/auth.json"]

# No machine_lines: the global opencode.json is provider and LSP selection,

# which is the same wherever you run it. Absolute paths show up in plugin

# source, not in config.

[commands]

format = 1

label = "OpenCode"

description = "Start the opencode TUI, run one-off messages or serve headless. Other subcommands are left out."

quality = "ai-draft"

base = "fig:opencode"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/opencode.ts"

license = "MIT"

[[commands.field]]

id = "project"

label = "Project directory"

type = "path"

position = 0

path = { kind = "directory", role = "input", must_exist = true }

sources = ["fig"]

[[commands.field]]

id = "model"

label = "Model"

description = "Format provider/model."

type = "string"

option = ["-m", "--model"]

sources = ["fig"]

[[commands.field]]

id = "continue"

label = "Continue last session"

type = "boolean"

option = ["-c", "--continue"]

sources = ["fig"]

[[commands.field]]

id = "session"

label = "Session ID"

type = "string"

option = ["-s", "--session"]

sources = ["fig"]

[[commands.field]]

id = "fork"

label = "Fork session"

description = "Use with continue or a session ID."

type = "boolean"

option = ["--fork"]

sources = ["fig"]

[[commands.field]]

id = "prompt"

label = "Prompt"

type = "string"

option = ["--prompt"]

sources = ["fig"]

[[commands.field]]

id = "agent"

label = "Agent"

type = "string"

option = ["--agent"]

sources = ["fig"]

[[commands.field]]

id = "pure"

label = "No external plugins"

type = "boolean"

option = ["--pure"]

sources = ["fig"]

[[commands.task]]

id = "open"

label = "Open in a project"

fields = ["project", "model", "agent"]

required = []

[[commands.task]]

id = "continue"

label = "Continue last session"

fields = ["project", "continue", "model"]

required = ["continue"]

[[commands.group]]

id = "basic"

label = "Basic"

fields = ["project", "model", "continue", "session", "prompt", "agent"]

[[commands.group]]

id = "advanced"

label = "Advanced"

fields = ["fork", "pure"]

[[commands.subcommand]]

path = ["run"]

label = "Run with a message"

description = "Run opencode non-interactively with a message. Server attach options are left out."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/opencode.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "message"

label = "Message"

type = "string"

position = 0

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "model"

label = "Model"

description = "Format provider/model."

type = "string"

option = ["-m", "--model"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "agent"

label = "Agent"

type = "string"

option = ["--agent"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "continue"

label = "Continue last session"

type = "boolean"

option = ["-c", "--continue"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "session"

label = "Session ID"

type = "string"

option = ["-s", "--session"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "format"

label = "Output format"

type = "enum"

option = ["--format"]

choices = [{ value = "default", label = "Formatted" }, { value = "json", label = "Raw JSON events" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "file"

label = "Attach files"

type = "path"

option = ["-f", "--file"]

multiple = true

path = { kind = "file", role = "input", must_exist = true }

sources = ["fig"]

[[commands.subcommand.field]]

id = "dir"

label = "Directory"

type = "path"

option = ["--dir"]

path = { kind = "directory", role = "input", must_exist = true }

sources = ["fig"]

[[commands.subcommand.field]]

id = "thinking"

label = "Show thinking"

type = "boolean"

option = ["--thinking"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "share"

label = "Share session"

type = "boolean"

option = ["--share"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "ask"

label = "Ask a question"

fields = ["message", "model", "file"]

required = ["message"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["message", "model", "agent", "continue", "file", "format"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["session", "dir", "thinking", "share"]

[[commands.subcommand]]

path = ["serve"]

label = "Start a headless server"

description = "Run an opencode server without the TUI."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/opencode.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "port"

label = "Port"

type = "integer"

option = ["--port"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "hostname"

label = "Hostname"

type = "string"

option = ["--hostname"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "mdns"

label = "mDNS discovery"

type = "boolean"

option = ["--mdns"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "cors"

label = "CORS domains"

type = "string"

option = ["--cors"]

multiple = true

sources = ["fig"]

[[commands.subcommand.task]]

id = "serve"

label = "Start server"

fields = ["port", "hostname"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["port", "hostname", "mdns", "cors"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/opencode. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps the credential file out.