opencode --version

opencode v2.1.3

DESCRIPTION
  OpenCode command line interface

USAGE
  opencode <subcommand> [flags] [<directory>]

ARGUMENTS
  directory string    Directory to start OpenCode in (optional)

FLAGS
  --standalone            Run with a private server instead of the background service
  --server string         Connect to a server URL instead of the background service
  --auto                  Auto-approve permissions that are not explicitly denied
  --continue, -c          Continue the last session
  --session, -s string    Session ID to continue, or to create if it does not exist
  --prompt string         Prompt to use

GLOBAL FLAGS
  --help, -h                                                          Show help information
  --version, -v                                                       Show version information
  --wizard                                                            Start wizard mode for a command
  --completions <bash|zsh|fish|sh>                                    Print shell completion script (choices: bash, zsh, fish, sh)
  --log-level <all|trace|debug|info|warn|warning|error|fatal|none>    Sets the minimum log level (choices: all, trace, debug, info, warn, warning, error, fatal, none)
  --print-logs                                                        Print logs to stderr (server logs require --standalone)

SUBCOMMANDS
  upgrade, update    Upgrade OpenCode to the latest or a specific version
  uninstall          Uninstall OpenCode, keeping session data, configuration, and state
  acp                Start an Agent Client Protocol server
  api                Make a request to the running server
  debug              Debugging and troubleshooting tools
  auth               manage integrations and credentials
  mcp                Manage MCP (Model Context Protocol) servers
  plugin             Manage plugins
  models             List all available models
  stats              Show shareable usage statistics
  mini               Start the minimal interactive interface
  run                Run OpenCode with a message
  session            Manage sessions
  service            Manage the background server
  reload             Reload configuration
  pair               Print one-time links to connect a browser or app
  serve              Start the v2 API and web server

cd /root/demo-app
opencode

                                                                 ▄
                                                                █▀▀█ █▀▀█ █▀▀█ █▀▀▄ █▀▀▀ █▀▀█ █▀▀█ █▀▀█
                                                                █  █ █  █ █▀▀▀ █  █ █    █  █ █  █ █▀▀▀
                                                                ▀▀▀▀ █▀▀▀ ▀▀▀▀ ▀  ▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀

  ┃
  ┃  Ask anything… "Fix broken tests"
  ┃
  ┃  Build · Qwen2.5 0.5B Ollama
  ╹▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  ~/demo-app:master                         shift+tab agents  ctrl+p commands

  ┃  用一句话说明 calc.py 中 add 函数的作用

     add 函数负责将两个数字相加。

     Build · Qwen2.5 0.5B · 7.8s · 1.4 tok/s

DESCRIPTION
  Run OpenCode with a message

USAGE
  opencode run [flags] [<message...>]

ARGUMENTS
  message... string    Message to send (optional)

FLAGS
  --standalone            Run with a private server instead of the background service
  --server string         Connect to a server URL instead of the background service
  --continue, -c          Continue the last session
  --session, -s string    Session ID to continue, or to create if it does not exist
  --fork                  Fork the session before continuing
  --model, -m string      Model to use in the format provider/model#variant
  --agent string          Agent to use
  --format choice         Output format (choices: default, json)
  --file, -f string       File to attach to the message
  --title string          Session title
  --thinking              Show thinking blocks
  --auto                  Auto-approve permissions that are not explicitly denied

cd /root/demo-app
opencode run "请用一句话回答：calc.py 里的 add 函数是做什么的？"

> build · qwen2.5:0.5b
"a函数"

opencode run --model ollama/qwen3:0.6b --auto "在当前目录创建 hello.txt，内容为一行文字 hello opencode，然后告诉我你完成了"

> build · qwen3:0.6b
← Write /currentDirectory
Created file successfully: /currentDirectory
> build · qwen3:0.6b
The file has been successfully created in the /currentDirectory directory.

opencode models [flags]

opencode models | grep -E 'ollama' | head -6

ollama-cloud/beam
ollama-cloud/deepseek-v4-pro
ollama-cloud/deepseek-v4-pro:0813
ollama-cloud/deepseek-v4.1-flash
ollama-cloud/deepseek-v4.1-flash:1017
ollama/qwen2.5:0.5b

SUBCOMMANDS
  list      list integrations and credentials
  login     connect an integration
  logout    log out of a saved account
  export    print stored credentials, including secrets, as JSON
  import    import credentials exported by auth export
  switch    switch the active account for an integration

Ollama        OLLAMA_API_KEY              environment
Ollama Cloud  OLLAMA_API_KEY              environment

opencode stats [flags]

opencode stats · today · all projects

activity
   Oct
Mo

Tu

We

Th █

Fr

Sa

Su

   less ·░▒▓█ more

SUBCOMMANDS
  list      List configured MCP servers and their status
  add       Add an MCP server to your configuration
  auth      Authenticate with an OAuth-capable remote MCP server
  logout    Remove stored OAuth credentials for an MCP server

opencode mcp add echo -- node /root/mcp/echo-mcp.mjs

MCP server "echo" added to /root/demo-app/opencode.json

{
  "mcp": {
    "servers": {
      "echo": {
        "type": "local",
        "command": [
          "node",
          "/root/mcp/echo-mcp.mjs"
        ]
      }
    }
  }
}

// 最小 MCP stdio 服务器：initialize / tools/list / tools/call
let buf = "";
process.stdin.on("data", (d) => {
  buf += d.toString();
  let idx;
  while ((idx = buf.indexOf("\n")) >= 0) {
    const line = buf.slice(0, idx).trim();
    buf = buf.slice(idx + 1);
    if (!line) continue;
    let msg; try { msg = JSON.parse(line); } catch { continue; }
    handle(msg);
  }
});
const send = (m) => process.stdout.write(JSON.stringify(m) + "\n");
function handle(msg) {
  if (msg.method === "initialize") {
    send({ jsonrpc: "2.0", id: msg.id, result: { protocolVersion: msg.params.protocolVersion, capabilities: { tools: {} }, serverInfo: { name: "echo-mcp", version: "1.0.0" } } });
  } else if (msg.method === "ping") {
    send({ jsonrpc: "2.0", id: msg.id, result: {} });
  } else if (msg.method === "tools/list") {
    send({ jsonrpc: "2.0", id: msg.id, result: { tools: [{ name: "echo", description: "Echo back the input text", inputSchema: { type: "object", properties: { text: { type: "string", description: "text to echo" } }, required: ["text"] } }] } });
  } else if (msg.method === "tools/call") {
    const text = msg.params?.arguments?.text ?? "";
    send({ jsonrpc: "2.0", id: msg.id, result: { content: [{ type: "text", text: "echo: " + text }] } });
  }
}

opencode reload
opencode mcp list

Configuration reloaded
✓ echo  connected

SUBCOMMANDS
  list      List plugins
  add       Install a plugin and add it to the global configuration
  check     Check package plugins for updates
  update    Update package plugins
  remove    Remove a plugin from global configuration

SUBCOMMANDS
  list      List top-level sessions in the current project, newest first
  delete    Delete a session and its child sessions
  export    Export session data as JSON
  import    Import session data from a JSON file or URL

ses_e9a5e32ccffenjx4M6ppMr5rEA  add 函数的作用是向包含的列表添加元素。  10/22/2026, 10:01:12 PM
ses_e9a5f25f7ffeLvlCxoRACBsUWM  hi.txt contents hello opencode  10/22/2026, 10:00:32 PM
ses_e9a5fdfc3ffekvNEdAfUCOWF8A  create hello.txt        10/22/2026, 9:59:54 PM
ses_e9a60b42bffeo346Q58i9AizGk  Create and update hello.txt     10/22/2026, 9:58:33 PM
ses_e9a61954affeyx9yqeNeGA9RoA  calc.py: add函数用于向列表中添加元素。  10/22/2026, 9:57:32 PM

SUBCOMMANDS
  start      Start the background server
  restart    Restart the background server
  status     Show background server status
  stop       Stop the background server
  get        Get service configuration
  set        Set service configuration
  unset      Unset service configuration

opencode service status

http://127.0.0.1:49374

opencode serve [flags]

opencode serve --port 4321 &

server listening on http://127.0.0.1:4321
server password 9zH4GOKffwsKBjDI8Leq9rJQ7XUhS67E8UDaFqFUktM

curl -s -o /dev/null -w "root=%{http_code}\n" http://127.0.0.1:4321/

root=200

{"_tag":"UnauthorizedError","message":"Authentication required"}

USAGE
  opencode api [flags] <operation | method path...>

ARGUMENTS
  operation | method path... string OpenAPI operation ID, or an HTTP method followed by a path

FLAGS
  --standalone           Run with a private server instead of the background service
  --server string        Connect to a server URL instead of the background service
  --data, -d string      Request body
  --header, -H string    Request header in name:value form
  --param key=value      OpenAPI path or query parameter

DESCRIPTION
  Print one-time links to connect a browser or app

FLAGS
  --url string    Use an external HTTP(S) server URL in pairing links
  --remote        Pair through the OpenTunnel remote address, enabling remote access if needed (exposes the server to the internet)
  --yes, -y       Accept exposing the server to the internet when --remote enables remote access for the first time (required without an interactive terminal)

SUBCOMMANDS
  agents    List all agents
  config    List configuration sources
  paths     Show global paths (data, config, cache, state)

home       /root
data       /root/.local/share/opencode
cache      /root/.cache/opencode
config     /root/.config/opencode
state      /root/.local/state/opencode
tmp        /tmp/opencode
bin        /root/.cache/opencode/bin
log        /root/.local/share/opencode/log
repos      /root/.local/share/opencode/repos
db         /root/.local/share/opencode/opencode.db

[
  {
    "type": "document",
    "path": "/root/.config/opencode/opencode.json",
    "info": {
      "$schema": "https://opencode.ai/config.json",
      "model": {
        "providerID": "ollama",
        "model": "qwen2.5:0.5b"
      },
      ...

[
  {
    "id": "build",
    "name": "Build",
    "request": {
      "settings": {},
      "headers": {},
      "body": {}
    },
    "description": "The default agent. Executes tools based on configured permissions.",
    "mode": "primary",
    "hidden": false,
    "permissions": [
      {
        "action": "*",
        "resource": "*",
        "effect": "allow"
      },
      {
        "action": "read",
        "resource": "*.env",
        "effect": "ask"
      },
      ...

Configuration reloaded

DESCRIPTION
  Upgrade OpenCode to the latest or a specific version

USAGE
  opencode upgrade [flags] [<target>]

ARGUMENTS
  target string    Version to upgrade to (with or without a leading v) (optional)

FLAGS
  --method, -m choice    Installation method to use (choices: curl, npm, pnpm, bun, yarn, vp, brew, winget)

DESCRIPTION
  Uninstall OpenCode, keeping session data, configuration, and state

USAGE
  opencode uninstall [flags]

FLAGS
  --dry-run      Show what would be removed without removing
  --force, -f    Skip confirmation prompts

┌  Uninstall OpenCode
│
●  Installation method: curl
│
│  The following global files will be removed (shared by OpenCode versions and channels):
│
●    Cache: /root/.cache/opencode
│
●    Binary (manual removal): /root/.opencode/bin/opencode
│
▲  Dry run - no changes made
│
└  Done

opencode --completions bash

###-begin-opencode-completions-###
#
# Static completion script for Bash
#
# Installation: