[Bug][SOLVED]: Command ':sage' and `:forge` not found after update

[mrosati84]

Bug Description

Hello,
after a recent update the :command syntax for switching agents in zsh does not work anymore. Here's a few examples:

➜  workdir git:(main) ✗ :sage                                                                                                                                                     󱙺 FORGE  gpt-5.4
⏺ [15:01:39] Command 'sage' not found

this happens also for :forge

➜  workdir git:(main) ✗ :forge                                                                                                                                                    󱙺 FORGE  gpt-5.4
⏺ [15:02:54] Command 'forge' not found

:sync seems to be working still. The CLI works fine when invoking forge directly and interacting with its shell.

I already attempted to remove and reinstall, it did not help.

Anyone else with this issue?

Steps to Reproduce

1. open the shell
2. type :sage
3. experience the described error message

Expected Behavior

:sage, :forge and all agent commands should work correctly in zsh.

Actual Behavior

:sage, :forge and all agent commands throw an error.

Forge Version

2.11.0

Operating System & Version

MacOS 26.4

AI Provider

OpenAI

Model

gpt-5.4

Installation Method

Other

Configuration

[mrosati84]

UPDATE: this was fixed reinstalling forge using npm. I have no idea why it does not work by installing using the official command.

[tusharmath]

Did u run exec zsh after updating?

[mrosati84]

Sure, I also completely restarted the shell just in case. Now the agent commands are working but the codebase indexing with :sync throws error for each file it tries to index. Weird...

[mrosati84]

UPDATE: also :sync is fixed now. apparently it requires the LLM provider to be authenticated and does not work otherwise. so In short, i used npm -g install to install forge, then in order to use :sync one must be sure to authenticate the provider first. Hope it's helpful