troubleshooting.md

description
Read this category if you have any issues with the framework or the CLI.

Troubleshooting

PSSecurityException on install

When using the CLI, your console displays an error of type PSSecurityException. (picture attached)

Fix PSSecurityException

Open your PowerShell as administrator and simply enter the following command.

set-executionpolicy remotesigned

Restricted imports

For any Node.js built-in package. Exemple for util:

import { inspect } from "util"

'util' import is restricted from being used by a pattern.

Fix restricted imports

Replace "util" by "node:util"

The CLI crashes on Bun after ~16 answers

The fix is not yet found. Issue 15174

The CLI's new command is stuck at the final step with Deno

Fix CLI stuck with Deno

Use bun or node to run the CLI instead. Example:

bot new
# or
npx @ghom/bot.ts-cli new
# or
bunx @ghom/bot.ts-cli new