fix(opencode): add trailing newline to help output

[spacelatte]

Issue for this PR

Closes #28606 & #26114

Type of change

• Bug fix
• New feature
• Refactor / code improvement
• Documentation

What does this PR do?

The --help output does not end with a newline. When used Zsh, this was not an issue as the shell prompt detects this and adds the newline automatically. But when used in a simple Bash shell, the subsequent prompt appears at the end of the last line.

How did you verify your code works?

• bun install && bun run dev -- --help -> validated prompt appears on a newline
• bun install && bun run dev -- --unknown-param -> validated prompt appears on a newline

Also fixes that the error message itself appears on a newline too, eg:

## BEFORE
      --fork         fork the session when continuing (use with --continue or --session)   [boolean]
      --prompt       prompt to use                                                          [string]
      --agent        agent to use                                                           [string]error: script "dev" exited with code 1
user@localhost:~/work/github.com/anomalyco/opencode$

## AFTER
      --fork         fork the session when continuing (use with --continue or --session)   [boolean]
      --prompt       prompt to use                                                          [string]
      --agent        agent to use                                                           [string]
error: script "dev" exited with code 1
user@localhost:~/work/github.com/anomalyco/opencode$

Screenshots / recordings

N/A, see excerpts below;

Before

user@localhost:~/work/github.com/anomalyco/opencode$ opencode --help
                                 ▄
█▀▀█ █▀▀█ █▀▀█ █▀▀▄ █▀▀▀ █▀▀█ █▀▀█ █▀▀█
█  █ █  █ █▀▀▀ █  █ █    █  █ █  █ █▀▀▀
▀▀▀▀ █▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀

Commands:
  opencode completion          generate shell completion script
  opencode acp                 start ACP (Agent Client Protocol) server
  opencode mcp                 manage MCP (Model Context Protocol) servers
  opencode [project]           start opencode tui                                          [default]
  opencode attach <url>        attach to a running opencode server
  opencode run [message..]     run opencode with a message
  opencode debug               debugging and troubleshooting tools
  opencode providers           manage AI providers and credentials                   [aliases: auth]
  opencode agent               manage agents
  opencode upgrade [target]    upgrade opencode to the latest or a specific version
  opencode uninstall           uninstall opencode and remove all related files
  opencode serve               starts a headless opencode server
  opencode web                 start opencode server and open web interface
  opencode models [provider]   list all available models
  opencode stats               show token usage and cost statistics
  opencode export [sessionID]  export session data as JSON
  opencode import <file>       import session data from JSON file or URL
  opencode github              manage GitHub agent
  opencode pr <number>         fetch and checkout a GitHub PR branch, then run opencode
  opencode session             manage sessions
  opencode plugin <module>     install plugin and update config                      [aliases: plug]
  opencode db                  database tools

Positionals:
  project  path to start opencode in                                                        [string]

Options:
  -h, --help         show help                                                             [boolean]
  -v, --version      show version number                                                   [boolean]
      --print-logs   print logs to stderr                                                  [boolean]
      --log-level    log level                  [string] [choices: "DEBUG", "INFO", "WARN", "ERROR"]
      --pure         run without external plugins                                          [boolean]
      --port         port to listen on                                         [number] [default: 0]
      --hostname     hostname to listen on                           [string] [default: "127.0.0.1"]
      --mdns         enable mDNS service discovery (defaults hostname to 0.0.0.0)
                                                                          [boolean] [default: false]
      --mdns-domain  custom domain name for mDNS service (default: opencode.local)
                                                                [string] [default: "opencode.local"]
      --cors         additional domains to allow for CORS                      [array] [default: []]
  -m, --model        model to use in the format of provider/model                           [string]
  -c, --continue     continue the last session                                             [boolean]
  -s, --session      session id to continue                                                 [string]
      --fork         fork the session when continuing (use with --continue or --session)   [boolean]
      --prompt       prompt to use                                                          [string]
      --agent        agent to use                                                           [string]user@localhost:~/work/github.com/anomalyco/opencode$

After

user@localhost:~/work/github.com/anomalyco/opencode$ opencode --help
                                 ▄
█▀▀█ █▀▀█ █▀▀█ █▀▀▄ █▀▀▀ █▀▀█ █▀▀█ █▀▀█
█  █ █  █ █▀▀▀ █  █ █    █  █ █  █ █▀▀▀
▀▀▀▀ █▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀

Commands:
  opencode completion          generate shell completion script
  opencode acp                 start ACP (Agent Client Protocol) server
  opencode mcp                 manage MCP (Model Context Protocol) servers
  opencode [project]           start opencode tui                                          [default]
  opencode attach <url>        attach to a running opencode server
  opencode run [message..]     run opencode with a message
  opencode debug               debugging and troubleshooting tools
  opencode providers           manage AI providers and credentials                   [aliases: auth]
  opencode agent               manage agents
  opencode upgrade [target]    upgrade opencode to the latest or a specific version
  opencode uninstall           uninstall opencode and remove all related files
  opencode serve               starts a headless opencode server
  opencode web                 start opencode server and open web interface
  opencode models [provider]   list all available models
  opencode stats               show token usage and cost statistics
  opencode export [sessionID]  export session data as JSON
  opencode import <file>       import session data from JSON file or URL
  opencode github              manage GitHub agent
  opencode pr <number>         fetch and checkout a GitHub PR branch, then run opencode
  opencode session             manage sessions
  opencode plugin <module>     install plugin and update config                      [aliases: plug]
  opencode db                  database tools

Positionals:
  project  path to start opencode in                                                        [string]

Options:
  -h, --help         show help                                                             [boolean]
  -v, --version      show version number                                                   [boolean]
      --print-logs   print logs to stderr                                                  [boolean]
      --log-level    log level                  [string] [choices: "DEBUG", "INFO", "WARN", "ERROR"]
      --pure         run without external plugins                                          [boolean]
      --port         port to listen on                                         [number] [default: 0]
      --hostname     hostname to listen on                           [string] [default: "127.0.0.1"]
      --mdns         enable mDNS service discovery (defaults hostname to 0.0.0.0)
                                                                          [boolean] [default: false]
      --mdns-domain  custom domain name for mDNS service (default: opencode.local)
                                                                [string] [default: "opencode.local"]
      --cors         additional domains to allow for CORS                      [array] [default: []]
  -m, --model        model to use in the format of provider/model                           [string]
  -c, --continue     continue the last session                                             [boolean]
  -s, --session      session id to continue                                                 [string]
      --fork         fork the session when continuing (use with --continue or --session)   [boolean]
      --prompt       prompt to use                                                          [string]
      --agent        agent to use                                                           [string]
user@localhost:~/work/github.com/anomalyco/opencode$

Checklist

• I have tested my changes locally
• I have not included unrelated changes in this PR

[github-actions]

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

1. Open an issue describing the bug/feature (if one doesn't exist)
2. Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

[github-actions]

The following comment was made by an LLM, it may be inaccurate:

Potential duplicate PRs found:

1. PR fix(opencode): add trailing newline to CLI help output #29898 - fix(opencode): add trailing newline to CLI help output

   • fix(opencode): add trailing newline to CLI help output #29898
   • Same fix, slightly different title wording

2. PR fix: add trailing newline to help output #26374 - fix: add trailing newline to help output

   • fix: add trailing newline to help output #26374
   • Addresses the identical issue from an earlier attempt

3. PR fix(cli): add newline to help output #28622 - fix(cli): add newline to help output

   • fix(cli): add newline to help output #28622
   • Same core fix with different scope notation

4. PR fix(opencode): ensure help output ends with newline #28643 - fix(opencode): ensure help output ends with newline

   • fix(opencode): ensure help output ends with newline #28643
   • Same fix with alternative wording in title

These PRs all address the exact same issue: adding a trailing newline to the help output to ensure the shell prompt appears on a new line. You should check the status of these existing PRs (merged, closed, or still open) before proceeding with PR #30547.

[github-actions]

Thanks for updating your PR! It now meets our contributing guidelines. 👍

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adjusts CLI stderr output formatting to always end messages with a newline.

Changes:

• Append EOL to non-opencode output written to stderr.
• Append EOL to normal opencode output written to stderr.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[spacelatte]

C'mon guys. These are fairly simple fixes that can be merged. Others can be closed as duplicates. Just annoying that prompt gets stuck at some other column than 0, unnecessary wrapping occurs.

The following comment was made by an LLM, it may be inaccurate:

Potential duplicate PRs found:

1. PR fix(opencode): add trailing newline to CLI help output #29898 - fix(opencode): add trailing newline to CLI help output

   • fix(opencode): add trailing newline to CLI help output #29898
   • Same fix, slightly different title wording

2. PR fix: add trailing newline to help output #26374 - fix: add trailing newline to help output

   • fix: add trailing newline to help output #26374
   • Addresses the identical issue from an earlier attempt

3. PR fix(cli): add newline to help output #28622 - fix(cli): add newline to help output

   • fix(cli): add newline to help output #28622
   • Same core fix with different scope notation

4. PR fix(opencode): ensure help output ends with newline #28643 - fix(opencode): ensure help output ends with newline

   • fix(opencode): ensure help output ends with newline #28643
   • Same fix with alternative wording in title

These PRs all address the exact same issue: adding a trailing newline to the help output to ensure the shell prompt appears on a new line. You should check the status of these existing PRs (merged, closed, or still open) before proceeding with PR #30547.