Documentation
Getting started
Install TuxNest, verify the active extension, connect an existing model runtime and run a deliberately small first task.
Requirements
- VS Code 1.106 or later.
- A trusted workspace for normal use; a disposable workspace is recommended for the first Agent task.
- An existing local Ollama installation, a user-owned remote Ollama host, or an explicit compatible API endpoint.
Install the extension
- Download the verified VSIX you intend to run.
- In VS Code, open the Command Palette.
- Run
Extensions: Install from VSIX…. - Select the package and reload the window.
Verify what actually loaded.Run
TuxNest: Diagnose Installation after installation. A filename alone is not proof of the active extension version.Open TuxNest
Use TuxNest: Open TuxNest SI Agent or open TuxNest Chat in the Secondary Sidebar. Model and mode selectors live near the composer.
Select a real model
Open Models and refresh discovery. Local Ollama models are discovered from the runtime; TuxNest should not invent a model that is not actually available. For remote GPU use, connect the host first.
First task
Start with a bounded read-only request:
Read README.md and package.json. Summarize the actual project and commands. Separate inspected facts from assumptions.
Only increase scope after reads, approvals, edits and verification behave as expected with the selected model.