LOCALCODEPILOT / PRACTICAL GUIDE
Getting started with LocalCodePilot on Windows
This guide covers version 0.4.0-alpha.8, available as an installer and a portable ZIP for Windows 10/11 x64. The product is in alpha: review its limitations and release notes before use.
1. Download the official release
Open the 0.4.0-alpha.8 release notes and download the installer LocalCodePilot-0.4.0-alpha.8-windows-x64-setup.exe (recommended) or the portable ZIP LocalCodePilot-0.4.0-alpha.8-windows-x64.zip.
2. Verify SHA-256
In PowerShell, run this command with the actual path to your downloaded file. Compare Hash with the SHA-256 published in that release. They must match. If they differ, do not run the file; download it again from the official release.
Get-FileHash -LiteralPath "$env:USERPROFILE\Downloads\LocalCodePilot-0.4.0-alpha.8-windows-x64-setup.exe" -Algorithm SHA256
3. Install and open the application
Run the installer: it installs the app in your user folder, without administrator rights, and adds a Start menu shortcut. The files in this version are not digitally signed yet; if Windows shows "Windows protected your PC", click More info and then Run anyway. If you prefer the ZIP, extract it to a folder and open LocalCodePilot.exe, not from inside the ZIP.
4. Select a project folder
Select directories containing local projects in the app. Discovery identifies technologies and structures while excluding dependencies and build artifacts. Start with a familiar test project to check detection.
5. Check requirements before starting
Review the detected technology, project requirements and suggested command. Detection does not mean every required runtime or tool is already installed. Follow the project's own setup instructions.
For supported services, use the available actions to prepare dependencies, start or stop execution and follow logs. Check the port and URL reported by the app.
When a service will not start
- Read the log and find the first error.
- Confirm that the required runtime is available.
- For port conflicts, read the Windows port troubleshooting guide.
- When reporting a bug, include the app version, Windows version, technology and reproduction steps. Remove tokens, passwords and private data from logs.
Containers and help in Alpha 8
LocalCodePilot can validate, start, inspect status and logs, stop, and build environments with Docker or Podman. The command is shown before confirmation; the engine must be installed and running.
The Help page summarizes first use, project states, databases, containers, and the steps for investigating a failure.
Download Windows alpha