Custom Text-Based Shell

A lightweight Python-based shell for Windows developers, students, and power users, featuring Git-aware prompts, system monitoring, process management, productivity shortcuts, and desktop notifications.

Demo

Installation

Download the latest executable from the Releases page:

👉 Download Latest Release

No Python installation required.

Quick Start

1. Download CustomShell.exe
2. Double-click the executable
3. Start using shell commands

Example:

C:\Users\Greg(main)> sysinfo

CPU: 14%
RAM: 52%
Battery: 89%

Features

• Git Integration – Automatically detects the active Git branch and displays it in the prompt.
• System Monitoring – View CPU, RAM, and battery usage instantly.
• Process Management – List running processes and terminate them by PID.
• Productivity Shortcuts – Open VS Code or File Explorer in the current directory.
• Built-in Timer – Countdown timer with native desktop notifications.
• Windows Command Fallback – Unknown commands are forwarded to the native Windows shell.

Why Custom Shell?

Unlike the default Windows Command Prompt, Custom Shell provides:

• Git-aware prompts
• Built-in system monitoring
• Process management
• Desktop notifications
• Productivity shortcuts
• Automatic fallback to Windows commands

Command Reference

Type help inside the shell to see the official command listing.

Command	Description
cd	Go to the home directory
cd [dir]	Navigate to a specific directory
pwd	Print the current working directory
dir	List files and folders
mkdir [name]	Create a folder
rmdir [folder]	Delete a folder
del [name]	Delete a file
copy [src] [dst]	Copy a file
move [src] [dst]	Move a file or folder
view [file]	Display a text file
history	Show command history
cls	Clear the screen
explorer	Open File Explorer
codehere	Open VS Code in the current directory
sysinfo	Show CPU, RAM, and battery usage
processes	List running processes
kill_process [pid]	Terminate a process
timer [seconds]	Start a countdown timer
network	Show network information
find [name]	Search for a specific file
help	Display available commands
exit / quit	Exit the shell

Implementation Details

Error Handling

Unknown commands are automatically executed using the Windows command interpreter (cmd.exe). If the command also fails there, the shell prints:

Unknown Command

Desktop Resilience

When running on a desktop system without a battery sensor, the shell safely displays:

Battery: No battery detected (Desktop)

instead of raising an exception.

Dependencies

• Python 3.11
• psutil
• plyer

License

MIT License