Skip to content

COMMANDS.md

Latest commit

 

History

History
411 lines (305 loc) · 10.2 KB

COMMANDS.md

File metadata and controls

411 lines (305 loc) · 10.2 KB

Complete Command Reference

All available commands in the PowerShell Dev Toolkit

Quick Reference

Category Commands
File & Editor e, npp, touch, open, o.
Directory ll, la, mkcd, temp
Utilities which, grep, sudo, reload, rc
Network ip, Clear-DNSCache
SSH cssh, tunnel, tssh
AI Integration ai-rules, context
Development port, proj, serve, gs, search, http, services, useenv, tail, clip, art
Toolkit Management Update-Toolkit

File & Editor Commands

e / npp

Edit file or folder in Notepad++

e .\file.txt                      # Edit file
e .\file.ps1 -Line 42 -Column 1   # Edit at specific line/column
e .                               # Open current folder in Notepad++
npp .\file.txt                    # Alias for 'e'

Edit-Profile

Open your PowerShell profile in Notepad++ for editing.

Edit-Profile

Edit-Hosts

Edit the Windows hosts file (requires admin elevation).

Edit-Hosts

Use-NppForGit

Configure Git to use Notepad++ as the default editor.

Use-NppForGit

touch

Create a new file or update an existing file's timestamp.

touch .\newfile.txt               # Create file or update timestamp

open

Open a file or folder with the default Windows application.

open .\document.pdf               # Open with default PDF viewer
open .\project                    # Open folder in Explorer

o.

Quick shortcut to open the current folder in Windows Explorer.

o.                                # Opens current directory

Directory Commands

ll

Enhanced directory listing with folders displayed first in a formatted table.

ll                                # List current directory
ll .\src                          # List specific directory

la

List all files including hidden files.

la                                # Show all files including hidden

mkcd

Create a directory and immediately navigate into it.

mkcd new-project                  # Create and enter directory

temp

Navigate to the Windows temp directory.

temp                              # cd to $env:TEMP

Utility Commands

which

Find the location of a command or executable.

which node                        # Find where node.exe is located
which git                         # Find git location

grep

Alias for Select-String - search for text patterns in files.

grep "pattern" .\file.txt         # Search in single file
grep "TODO" *.ps1                 # Search in all .ps1 files

sudo

Run a command with administrator privileges.

sudo notepad C:\Windows\System32\drivers\etc\hosts
sudo choco install nodejs

Add-Path

Add a directory to the system or user PATH.

Add-Path "C:\tools\bin"           # Add to system PATH
Add-Path "C:\tools\bin" -User     # Add to user PATH only

reload

Reload your PowerShell profile without restarting the terminal.

reload                            # Applies profile changes

recent-commands / rc

Display recent unique PowerShell commands with pagination.

rc                                # Show first page (30 commands)
rc -Interactive                   # Interactive pagination mode
rc -Page 2                        # Show page 2
rc -Count 200 -PageSize 50        # Custom count and page size

Network Commands

ip

Show IPv4 addresses (excludes link-local 169.* addresses).

ip                                # Display all valid IPv4 addresses

Clear-DNSCache / Flush-DNS

Flush the Windows DNS cache.

Clear-DNSCache                    # Flush DNS
Flush-DNS                         # Alias

SSH Commands

See SSH Setup Guide for configuration details.

Connect-SSH / cssh

Connect to an SSH server using saved credentials.

cssh myserver                     # Connect using server alias
cssh server.example.com           # Connect using hostname directly

Connect-SSHTunnel / tunnel / tssh

Create an SSH tunnel for database connections or other services.

tunnel myserver                   # Default MySQL tunnel (3306)
tunnel myserver postgres          # PostgreSQL tunnel (5432)
tunnel myserver mysql 3307        # MySQL with custom local port
tunnel myserver 5432 5433         # Custom remote and local ports
tunnel myserver 3306 -RemoteHost db.internal  # Tunnel to internal host

Database Shortcuts:

Shortcut Port
postgres / postgresql 5432
mysql / mariadb 3306
mssql / sqlserver 1433
mongodb / mongo 27017
redis 6379
oracle 1521

AI Integration Commands

ai-rules

Generate AI rules files for various coding assistants.

ai-rules php                      # Generate .airules (generic)
ai-rules laravel -RuleType Cursor # Generate .cursorrules
ai-rules react -RuleType Claude   # Generate .clauderules
ai-rules -Auto                    # Auto-detect project type

Supported Project Types:

  • PHP, Laravel
  • JavaScript, TypeScript, React, Vue, Angular, Next.js
  • Python, Django, Flask
  • Node.js, Express
  • And more...

Rule Types:

Type Output File
Generic (default) .airules
Cursor .cursorrules
Claude .clauderules

context

Generate a project summary for AI tools.

context                           # Full project context
context -Brief                    # Short summary
context -AsJson                   # JSON output for MCP tools
context -Copy                     # Copy to clipboard

Development Commands

port

Find and manage processes using specific ports.

port 3000                         # Show what's using port 3000
port 3000 -Kill                   # Kill the process on port 3000
port -List                        # Show all listening ports

proj

Detect and show project type information.

proj                              # Show project type for current dir
proj -AsJson                      # JSON output for AI tools

serve

Auto-detect project type and start the appropriate dev server.

serve                             # Auto-detect and start server
serve -Port 8080                  # Use custom port
serve php                         # Force PHP built-in server
serve node                        # Force Node.js server

Auto-Detection:

  • package.json - npm/yarn start
  • composer.json - PHP built-in server
  • manage.py - Django runserver
  • requirements.txt - Python HTTP server

gs

Quick git status with enhanced branch information.

gs                                # Pretty git status
gs -AsJson                        # JSON output for AI tools

search

Search for patterns across project files.

search "function login"           # Search all files
search "TODO" -Type php           # Only PHP files
search "import" -Type js,ts       # JavaScript and TypeScript files

http

Quick HTTP requests from the command line.

http GET http://localhost:3000/api/health
http POST http://localhost:3000/api -Body @{name='test'}
http PUT http://localhost:3000/api/1 -Body @{name='updated'}
http DELETE http://localhost:3000/api/1

services

Check the status of development services.

services                          # Show all common services
services docker node postgres     # Check specific services

useenv

Load environment variables from a .env file into the current session.

useenv                            # Load .env from current directory
useenv .env.local                 # Load specific env file
useenv -Show                      # Show current environment variables

tail

Watch and tail log files with optional filtering.

tail .\logs\app.log               # Watch log file
tail .\logs\app.log -Filter "error"    # Filter for errors
tail .\logs\app.log -Filter "warning"  # Filter for warnings

clip

Copy file contents or paths to clipboard.

clip .\config.json                # Copy file contents to clipboard
clip .\config.json -Path          # Copy file path to clipboard
clip -Pwd                         # Copy current directory path

art

Laravel Artisan command helper.

art migrate                       # Run migrations
art make:model User -m            # Create model with migration
art make:controller UserController
art tinker                        # Interactive REPL
art route:list                    # List all routes
art cache:clear                   # Clear application cache

Toolkit Management

Update-Toolkit

Self-update the toolkit by pulling the latest changes from git.

Update-Toolkit                    # Pull latest, show changes, reload module
Update-Toolkit -CheckOnly         # Check for updates without applying
Update-Toolkit -Force             # Skip confirmation prompt

After updating, the module is re-imported automatically so new commands and aliases are available immediately.

Automatic Update Checks:

The toolkit checks for available updates once per day on shell startup (configurable). To change the frequency, set toolkit.updateCheckDays in config.json:

{
  "toolkit": {
    "updateCheckDays": 7
  }
}

Set to 0 to disable automatic checks entirely.

Keyboard Shortcuts

Shortcut Action
Up / Down Search command history by prefix
Ctrl+R Reverse search through history

Getting Help

helpme                            # Show all commands
helpme -ProfileOnly               # Show only profile commands
helpme -ScriptsOnly               # Show only script commands