Documentation

Complete guide to using the Dev PowerShell Utility

Installation

Inno Setup (Recommended)

  1. 1. Download the installer from the releases page
  2. 2. Run the installer and follow the prompts
  3. 3. Reload your PowerShell profile: . $PROFILE

Chocolatey

choco install dev-ps-utils -y

Note: Chocolatey package may not be immediately updated with the latest release.

From Source

Clone the repository:

git clone https://github.com/SzaBee13/dev-tools-ps.git

Navigate to the directory:

cd dev-tools-ps

Run the main script:

. .\src\dev.ps1

Configuration

Dev stores its configuration in %appdata%\SzaBee13\dev\config.json

Set default behavior:

dev set --code=truedev set --explorer=false

These settings control whether VSCode and Windows Explorer open automatically when working with projects.

Root Management

Roots are base directories where your projects are organized. Set up roots for different project types:

Define a new root:

dev set root web "D:/my-web-projects"

List all roots:

dev roots

Commands Reference

$ dev open <folder-name>

Open a project folder in VSCode and/or Explorer

Example: $ dev open my-website
$ dev create <type> <name>

Create a new project of specified type (vite, python, discord, etc.)

Example: $ dev create vite my-app
$ dev rm <folder-name>

Remove a folder from your root directories

Example: $ dev rm old-project
$ dev pull [repo-url] [folder]

Clone or pull a Git repository

Example: $ dev pull https://github.com/user/repo my-project
$ dev release <message> [details]

Commit and push changes to Git

Example: $ dev release "Add new feature" "Implemented user auth"
$ dev local-release <message>

Commit changes locally without pushing

Example: $ dev local-release "WIP: working on feature"
$ dev init [repo-url]

Initialize a Git repository with optional remote

Example: $ dev init https://github.com/user/repo
$ dev status

Show git status of the current directory

Example: $ dev status
$ dev ls <type>

List all projects in a specific root (web, python, discord, etc.)

Example: $ dev ls web
$ dev help

Display help information

Example: $ dev help

Project Operations

Opening Projects

The dev open command supports subpaths:

dev open my-project/subdirectory

Override Defaults

Override default VSCode/Explorer behavior per command:

dev open my-project --code=false --explorer=true

Git Integration

Dev includes powerful Git integration to streamline version control:

Auto-pull on open

When opening a folder with dev open, it automatically checks if it's a Git repository with a remote and pulls the latest changes.

Quick commits

Use dev release for quick commits and push:

dev release "Fixed bug in login" "- Updated validation
- Added error handling"

Examples

Complete Workflow Example

1. Set up a web projects root

dev set root web "D:/web-projects"

2. Create a new Vite project

dev create vite my-portfolio

3. Work on your project...

4. Commit and push changes

dev release "Initial commit" "Created portfolio structure"

5. Open the project later

dev open my-portfolio

Need More Help?

Check out the GitHub repository for more examples and community support

View on GitHubRelease Notes