Documentation

Troubleshooting

Diagnose missing models, version mismatches, remote disconnects, stalled tasks, validation failures and source builds.

No local models appear

Confirm Ollama is installed and reachable, then run TuxNest: Refresh Models. If auto-start is disabled, start Ollama yourself before refreshing.

Unexpected extension version

Run TuxNest: Diagnose Installation and inspect the active extension path/version instead of assuming the newest-looking VSIX filename is installed.

Remote models disappeared

Check whether the SSH tunnel, GPU studio or remote Ollama process closed. Restart the remote service if needed, reconnect and explicitly retry.

Agent appears stuck

Use Stop and wait for cancellation acknowledgement. Inspect pending approval cards, running commands and the activity timeline before restarting work.

Tests failed

A failing or missing test remains a failure. Review the exact command and output. Do not treat partial generated text or a proposal awaiting review as completion.

Source build

npm ci
npm test
npm run package

Package the exact revision you tested and avoid silently overwriting a preserved release artifact.