Running the opencode CLI starts it for the current directory.

opencode

Or you can start it for a specific working directory.

opencode /path/to/project

The opencode CLI also has the following commands.

Run opencode in non-interactive mode by passing a prompt directly.

opencode run [message..]

This is useful for scripting, automation, or when you want a quick answer without launching the full TUI. For example.

opencode run Explain the use of context in Go

Command to manage credentials and login for providers.

opencode auth [command]

opencode is powered by the provider list at Models.dev, so you can use opencode auth login to configure API keys for any provider you'd like to use. This is stored in ~/.local/share/opencode/auth.json.

opencode auth login

When opencode starts up it loads the providers from the credentials file. And if there are any keys defined in your environments or a .env file in your project.

Lists all the authenticated providers as stored in the credentials file.

opencode auth list

Or the short version.

opencode auth ls

Logs you out of a provider by clearing it from the credentials file.

opencode auth logout

Updates opencode to the latest version or a specific version.

opencode upgrade [target]

To upgrade to the latest version.

opencode upgrade

To upgrade to a specific version.

opencode upgrade v0.1.48

The opencode CLI takes the following flags.