Troubleshooting

Check the installed version

snsagent --version
snsagent --help

Expected version for this release:

snsagent 0.3.9

Compiled binary shows a blank TUI / “JS-only mode”

The compiled binary (./bin/snsagent-linux-x64, and the npm-installed binary) prints:

[pi-natives] JS-only mode: native addon unavailable for linux-x64 (modern)
[pi-natives] Native features (grep, pty, shell, clipboard, syntax highlighting, etc.) are disabled.

and the interactive TUI does not render. The compiled bundle does not embed the native .node addon, so native terminal features are off.

Note

this is a known limitation of the compiled binary, not a crash. The npm-installed binary behaves the same way because the bundle does not embed the native addon.

Workaround: run from source with Bun, which loads the native addon normally:

bun install
bun run src/cli/entry.ts

`command not found: snsagent`

Check whether the package is installed globally:

npm ls -g --depth=0
command -v snsagent

Install it with:

npm install -g @sns-myagent/cli

Tip

if you used the shell installer, reload the shell (or run export PATH="$HOME/.local/bin:$PATH") so ~/.local/bin is on PATH.

Provider or model errors

Run /setup in the interactive agent, then verify the Base URL, API type, model ID, and credentials. For a hand-written setup, inspect ~/.omp/agent/models.yml without printing secret values.

No model is selected

Check the provider definitions and role assignment:

/model

If orchestration is involved, verify modelRoles.default in ~/.omp/agent/config.yml.

Permission denied for a source-built binary

Only for a binary built from source:

chmod +x bin/snsagent-linux-x64
./bin/snsagent-linux-x64 --version

Bun is missing

Bun is required for source execution and builds, but not for the normal npm install. Install Bun when using source mode:

curl -fsSL https://bun.sh/install | bash
export PATH="$HOME/.bun/bin:$PATH"

Memory database is locked

Warning

stop snsagent before copying or repairing SQLite state, and do not delete journal files while another process is running. Check for active processes first:

pgrep -af snsagent

The interactive agent stores state below ~/.omp/agent. The mnemopi database is below that directory’s memories/ tree.

Telegram not responding

Check the adapter status and token source:

snsagent telegram status

For a service, verify SNS_TELEGRAM_BOT_TOKEN in /etc/snsagent/secrets.env and inspect:

sudo systemctl status snsagent
journalctl -u snsagent -e

Build problems

bun install
bun run check
bun run build

If native optional dependencies fail during installation, retry with the repository’s supported Bun version and inspect the first native-module error before removing files.

Still stuck?

Open an issue at https://github.com/Reihantt6/sns-myagent/issues with the exact command, output, operating system, Node or Bun version, and a redacted configuration summary.