WSL Terminal
Docs/WSL Terminal

WSL Terminal

Connect to your Windows Subsystem for Linux distributions with full terminal features.

Overview

NeuroTerm provides native WSL support, allowing you to connect to any installed WSL distribution directly from the app. This includes full terminal emulation, proper PTY sizing, and integrated file browsing through Windows' \\wsl$\ UNC paths.

Zero configuration

WSL connections work out of the box. Just select your distribution and connect.

Creating a WSL Connection

  1. 1

    Click the + button in the sidebar or use Ctrl+N

  2. 2

    Select WSL as the connection type

  3. 3

    Choose your distribution from the dropdown (e.g., Ubuntu, Debian, Arch)

  4. 4

    Click Connect

Features

Full Terminal Emulation

Complete xterm compatibility with proper ANSI escape sequences, colors, and cursor positioning.

Integrated File Browser

Browse your WSL filesystem directly from the sidebar. Files are accessed via Windows'\\wsl$\distro-name\ UNC paths.

Automatic Distribution Detection

NeuroTerm automatically detects all installed WSL distributions and lists them in the connection dropdown.

All NeuroTerm Features

WSL sessions support Neuro Input, pattern highlighting, minimap markers, auto-reply, and all other features.

Requirements

  • Windows 10 version 1903+ or Windows 11
  • WSL 2 installed and configured
  • At least one WSL distribution installed

Troubleshooting

No distributions found

Run wsl --list --verbose in PowerShell to verify your WSL installation. If no distributions appear, install one from the Microsoft Store.

Connection fails immediately

Ensure WSL is running. Try wsl --status to check the current state. You may need to run wsl --shutdown and reconnect.

SSH TerminalSFTP