A tiny, fast command-line launcher for switching between local dev projects.
Type dev in any terminal and instantly:
- Open the project folder in VS Code
- Start the dev server (e.g.
npm run dev) in its own window - Open the local URL in your browser
- Open the GitHub repo page
No more cd-ing around, no more remembering ports, no more retyping the same three commands every time you sit down to work.
- One command (
dev) launches your whole workspace - Direct launch:
dev <novaflow>skips the menu entirely - Project registry in a single
projects.jsonfile — add a project by editing one line - Works from any terminal, any folder once installed
- Built on Nushell — fast, cross-platform, scriptable
| Tool | Purpose | Link |
|---|---|---|
| Nushell | Runs the launcher script | nushell.sh |
| VS Code | Opens your projects | code.visualstudio.com |
| Windows 10/11 | PATH setup script targets Windows (.cmd + PowerShell) |
— |
Using macOS/Linux? The core
launcher.nuscript works as-is — just skipdev.cmd/setup.ps1and add an alias to your shell profile instead (see Manual setup).
git clone https://github.com/<the-bipu>/novaflow.git
cd novaflowDownload from nushell.sh, or via winget:
winget install nushellpowershell -ExecutionPolicy Bypass -File setup.ps1This adds the project folder to your User PATH, so the dev command is available everywhere.
Close and reopen your terminal after this step.
Open projects.json and list your own projects:
{
"projects": [
{
"name": "my-app",
"path": "E:/Projects/my-app",
"frontend": "npm run dev",
"url": "http://localhost:3000",
"github": "https://github.com/you/my-app"
}
]
}| Field | Description |
|---|---|
name |
Short identifier you'll type to launch the project |
path |
Absolute path to the project folder |
frontend |
Command to start the dev server (leave "" to skip) |
url |
Local URL to open in browser (leave "" to skip) |
github |
GitHub repo URL to open (leave "" to skip) |
devor jump straight into a project:
dev my-appdev # shows a menu of all projects, prompts for a name
dev sliet-alumni # launches that project directly, no promptIf you're not on Windows, or don't want to run setup.ps1:
- Add this folder to your
PATHmanually. - Create a
devalias/script that callsnu launcher.nufrom this folder, e.g. in~/.bashrcor~/.zshrc:alias dev="nu /path/to/dev-launcher/launcher.nu"
- Reload your shell (
source ~/.bashrc) and rundev.
dev-launcher/
├── launcher.nu # Main script
├── config.nu # Nushell startup banner/hints
├── dev.cmd # Windows PATH entry point
├── setup.ps1 # One-time PATH installer (Windows)
├── projects.json # Your project registry (edit this!)
└── README.md
Issues and PRs welcome. Ideas on the roadmap:
- Backend command support (run frontend + backend together)
- Fuzzy project-name matching
- Auto
git pullbefore opening - Cross-platform installer script
MIT — free to use, modify, and share.