CLI errors

Reasonix command-line troubleshooting checklist

Use these commands to check Node/npm, DeepSeek API keys, Go build tooling, and terminal interaction issues without exposing secrets.

npx reasonix code does not start or resolves the wrong version

node -v
npm view reasonix engines
npm view reasonix dist-tags
npm cache verify
npx reasonix@latest code

Use live npm metadata for the current Node requirement and package tags. Clear npm cache or pin the intended tag if npx resolves an unexpected package.

DeepSeek API key is missing or credentials expired

open https://platform.deepseek.com/api_keys
printenv DEEPSEEK_API_KEY
npx reasonix code

Confirm that a DeepSeek Platform API key exists first. Do not commit keys to public repositories.

Source build cannot find make or Go

go version
make --version
git switch main-v2
make build

main-v2 is the Go rewrite branch, so source builds require a Go toolchain and make.

Terminal scrolling, selection, or paste behaves incorrectly

echo $TERM
printf '\e[?1000h'
# Windows users should also review Git for Windows and Windows Terminal settings

GitHub issue #2649 tracks Windows Terminal scrolling, PageUp/PageDown, and selection-copy behavior.

Messages beginning with # are not received by the agent

npx reasonix@latest code
# Temporary workaround: add a leading space or newline, then follow issue #2658

This was still an open GitHub bug report on 2026-06-02, so it belongs in the error tracking area.

Need to confirm DeepSeek API connectivity

curl -s https://api.deepseek.com | head
# Then return to Reasonix and run /help or /pro to verify model switching

Network reachability is not the same as successful authentication. Key and Reasonix config still need separate checks.

GitHub issue tracker

#2658Messages starting with # are not received by the agent #2652Terminal button styling issue #2649Windows Terminal scroll, PageUp/PageDown, and copy-paste issue