Skip to content

opencode stuck to run #8383

Closed
Closed

Description

@PhantomYdn

Description

Today I have implemented custom command. And after that opencode stopped to run. When run like this opencode --print-logs --log-level DEBUG it shows only this:

INFO  2026-01-14T06:38:18 +378ms service=default version=1.1.10 args=["--print-logs","--log-level","DEBUG","-c"] opencode
INFO  2026-01-14T06:38:18 +1ms service=config path=/Users/phantom/.config/opencode/config.json loading
INFO  2026-01-14T06:38:18 +0ms service=config path=/Users/phantom/.config/opencode/opencode.json loading
INFO  2026-01-14T06:38:18 +6ms service=config path=/Users/phantom/.config/opencode/opencode.jsonc loading

Only running opencode web helped to clarify the situation. In a browser I found the following:

{"name":"ConfigFrontmatterError","data":{"path":"/Users/phantom/.config/opencode/command/reflect.md","message":"Failed to parse YAML frontmatter: incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line at line 2, column 39:\n     ... ption: End-of-session reflection: checklist items and documentat ... \n                                         ^"}}

Apprarantly problem was a character ":" at a command description. Seems that there are multiple things which worst to address:

  • Proper handling of wrong YAML
  • Proper logging such cases
  • Potential repeating the case for other entities like agents and skills

Plugins

No response

OpenCode version

1.1.10

Steps to reproduce

  1. Create a global command with using extra ":" at command description
  2. Try to restart opencode
  3. It just stuck without any messages
  4. Enabling logging is not helping much

Screenshot and/or share link

No response

Operating System

MacOs 26

Terminal

Kitty + tmux

Activity

  1. github-actions commented on Jan 14, 2026

    @github-actions
    Contributor

    This issue might be a duplicate of existing issues. Please check:

    Feel free to ignore if none of these address your specific case.

  2. c2v4 commented on Feb 2, 2026

    @c2v4

    @PhantomYdn how did you come up with
    {"name":"ConfigFrontmatterError","data":{"path":"/Users/phantom/.config/opencode/command/reflect.md","message":"Failed to parse YAML frontmatter: incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line at line 2, column 39:\n ... ption: End-of-session reflection: checklist items and documentat ... \n ^"}}
    I'd like to debug my istance since it hungs as well

  3. bayov commented on Feb 21, 2026

    @bayov

    I don't know how to get opencode to print what it didn't like about my opencode.jsonc configuration (neither command-line args for logs nor logs written to file with opencode web showed what's wrong), but I did a binary search to find the problematic config...

    For me it was:

      "server": {
        "port": 4096
      }

    So opencode automatically updated, no longer supports this configuration (?), and won't start anymore, hangs forever, doesn't even tell you what's wrong. Sigh.

  4. github-actions commented on Apr 23, 2026

    @github-actions
    Contributor

    To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions