TUI will not start (Directory commands DNE) #2173

Closed
opened 2026-02-16 17:34:31 -05:00 by yindo · 5 comments
Owner

Originally created by @chaptersix on GitHub (Oct 19, 2025).

Originally assigned to: @rekram1-node on GitHub.

Description

After installing the newest version of opencode I can't start the TUI or opencode auth login. When I attempt to start it returns the following error:

Error: Directory "commands" in /Users/<username>/.opencode is not valid. Use "command" instead. This is a common typo.

Environment:

  • Shell: fish (tried to start with bash)

Steps to reproduce

Note:

  • I tried to rm -rf ~/.config/opencode/ then re-run opencode but got the same error
  • I have another tools named opencode installed but I removed it by brew uninstall opencode after I received a warning from homebrew that I can't have a 2 different tools by the same name installed. code snippet below
  • I tried installing with brew, uninstalled then installed via curl -fsSL https://opencode.ai/install | bash
> brew install opencode
Error: opencode was installed from the opencode-ai/tap tap
but you are trying to install it from the homebrew/core tap.
Formulae with the same name from different taps cannot be installed at the same time.

To install this version, you must first uninstall the existing formula:
  brew uninstall opencode
Then you can install the desired version:
  brew install opencode
❯ brew uninstall opencode
Uninstalling /opt/homebrew/Cellar/opencode/0.0.55... (6 files, 41.2MB)
❯ brew install opencode

Steps:

  1. brew install opencode or curl -fsSL https://opencode.ai/install | bash
  2. opencode auth login (same error when running opencode)

Screenshot and/or share link

No response

Operating System

MacOSX Sequoia 15.6.1

Terminal

Ghostty

OpenCode version

0.15.8

Originally created by @chaptersix on GitHub (Oct 19, 2025). Originally assigned to: @rekram1-node on GitHub. ### Description After installing the newest version of opencode I can't start the TUI or `opencode auth login`. When I attempt to start it returns the following error: ``` Error: Directory "commands" in /Users/<username>/.opencode is not valid. Use "command" instead. This is a common typo. ``` Environment: * Shell: fish (tried to start with bash) ### Steps to reproduce Note: * I tried to `rm -rf ~/.config/opencode/` then re-run `opencode` but got the same error * I have another tools named opencode installed but I removed it by `brew uninstall opencode` after I received a warning from homebrew that I can't have a 2 different tools by the same name installed. code snippet below * I tried installing with brew, uninstalled then installed via `curl -fsSL https://opencode.ai/install | bash` ``` > brew install opencode Error: opencode was installed from the opencode-ai/tap tap but you are trying to install it from the homebrew/core tap. Formulae with the same name from different taps cannot be installed at the same time. To install this version, you must first uninstall the existing formula: brew uninstall opencode Then you can install the desired version: brew install opencode ❯ brew uninstall opencode Uninstalling /opt/homebrew/Cellar/opencode/0.0.55... (6 files, 41.2MB) ❯ brew install opencode ``` Steps: 1. `brew install opencode` or `curl -fsSL https://opencode.ai/install | bash` 2. `opencode auth login` (same error when running `opencode`) ### Screenshot and/or share link _No response_ ### Operating System MacOSX Sequoia 15.6.1 ### Terminal Ghostty ### OpenCode version 0.15.8
yindo added the bug label 2026-02-16 17:34:31 -05:00
yindo closed this issue 2026-02-16 17:34:31 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Oct 19, 2025):

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

  • #3252: Same exact error message about "commands" directory not being valid on Windows
  • #3240: Identical error on Linux after installing recent version
  • #3236: Same error after brew update to v0.15.7 on macOS

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

@github-actions[bot] commented on GitHub (Oct 19, 2025): This issue might be a duplicate of existing issues. Please check: - #3252: Same exact error message about "commands" directory not being valid on Windows - #3240: Identical error on Linux after installing recent version - #3236: Same error after brew update to v0.15.7 on macOS Feel free to ignore if none of these address your specific case.
Author
Owner

@rekram1-node commented on GitHub (Oct 19, 2025):

@chaptersix the error comes from an invalid configuration in /Users/<username>/.opencode

You mentioned that you ran rm -rf ~/.config/opencode/ but the error was for ~/.opencode and all that you need to do is mv ~/.opencode/commands ~/.opencode/command

@rekram1-node commented on GitHub (Oct 19, 2025): @chaptersix the error comes from an invalid configuration in `/Users/<username>/.opencode` You mentioned that you ran `rm -rf ~/.config/opencode/` but the error was for `~/.opencode` and all that you need to do is `mv ~/.opencode/commands ~/.opencode/command`
Author
Owner

@chaptersix commented on GitHub (Oct 19, 2025):

Thank you for the quick response. I looks like this was a conflict from some files left over from: https://github.com/opencode-ai/opencode

The /Users/<username>/.opencode directory had completely different structure to id than ~/.config/opencode/

@chaptersix commented on GitHub (Oct 19, 2025): Thank you for the quick response. I looks like this was a conflict from some files left over from: https://github.com/opencode-ai/opencode The `/Users/<username>/.opencode` directory had completely different structure to id than ` ~/.config/opencode/`
Author
Owner

@chaptersix commented on GitHub (Oct 19, 2025):

I removed /Users/<username>/.opencode and now I'm good to go.

@chaptersix commented on GitHub (Oct 19, 2025): I removed `/Users/<username>/.opencode` and now I'm good to go.
Author
Owner

@rekram1-node commented on GitHub (Oct 19, 2025):

happy to help

@rekram1-node commented on GitHub (Oct 19, 2025): happy to help
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#2173