Troubleshooting

hellyeah: command not found

You haven't run the install bootstrap yet, or the install directory isn't on your shell's PATH. Run:

npx hellyeah install

The output tells you which directory the binary was symlinked into (typically ~/.local/bin on macOS/Linux). Make sure that directory is on your PATH, then reload your shell:

exec $SHELL
hellyeah --help

Install fails or fetch is slow

The first npx hellyeah install downloads the package. If the network drops or npm misbehaves, clear the npx cache and retry:

npx clear-npx-cache
npx hellyeah install

If you saw an error about missing optional dependencies, force a fresh fetch:

npx hellyeah@latest install

Auth looks stale

Check the current account:

hellyeah auth whoami

If it is wrong, sign out and sign in again:

hellyeah auth logout
hellyeah auth login

The agent does not know Hellyeah commands

Install or reinstall the skill:

hellyeah skills add hellyeah

Then restart the agent session so it reloads local skills.

Launch fails because the wallet is low

Top up the prepaid wallet, then rerun the launch:

hellyeah wallet topup --amount 50
hellyeah wallet balance

Wallet top-ups open Stripe Checkout in your browser. Your agent cannot enter card details or add funds on its own.

Tracking is not linked

Create or find a tracker, then link it to the project:

hellyeah tracker list
hellyeah tracker link <trackerId>

Install the SDK with Tracking or the Install the SDK guide.

Report a bug

Send feedback from the CLI:

hellyeah feedback "what happened"

The positional message is filed as kind: "note". For structured agent reports (crashes, suggestions), pipe JSON to hellyeah feedback — see the reference.