This repository was archived by the owner on Aug 26, 2026. It is now read-only.
BranchesTags

Repository files navigation

esh — Easy Shell for Windows

esh (Easy Shell) is an experimental command-line shell written in modern C++ for Windows.

The project focuses on understanding shell internals, command execution flow, and Windows API–based system programming rather than providing a fully featured production shell.

esh is a completed learning-oriented systems programming project.

Goals

  • Understand how a shell parses and executes commands
  • Learn Windows API fundamentals relevant to process and file management
  • Design a clean internal command/flag/symbol architecture
  • Gain experience with Unicode handling (UTF-8 / UTF-16) on Windows
  • Build a non-trivial C++ project with clear structure and layering

Features

  • Built-in commands (file, process, system, and shell commands)
  • Command grouping and internal command registry
  • Flag-based command behavior
  • Pipeline and redirection parsing
  • JSON-based help system
  • Unicode-safe input and output
  • Colored console output

Project Structure

esh/
├─ src/
│ ├─ core/ # Core shell engine (parser, lexer, execution flow)
│ ├─ commands/ # Built-in command implementations
│ ├─ execution/ # Command execution and process control
│ ├─ file/ # File-related commands and utilities
│ ├─ process/ # Process-related commands
│ ├─ env/ # Environment-related commands
│ ├─ shell/ # Shell-specific commands and logic
│ ├─ system/ # System information and system commands
│ ├─ history/ # Command history management
│ ├─ platform/ # Platform-specific utilities (Windows)
│ ├─ headers/ # Public headers and shared interfaces
│ ├─ external/ # Third-party headers (e.g. JSON)
│ └─ consoleOperations # Console-related operations
│
├─ resources.rc # Embeds json file to .exe
├─ app.rc # Windows resource file
├─ icon/esh.ico # Application icon
│
├─ build/ # Build output (not tracked)
├─ esh.json # Command help and metadata
├─ CMakeLists.txt # CMake configuration
├─ Makefile # Build entry point
├─ README.md
└─ LICENSE

Build Information

  • Language: C++ (modern standard)
  • Compiler: LLVM Clang (Windows)
  • Platform: Windows (Win32 API)
  • Encoding: UTF-16 internally, UTF-8 at boundaries
  • Build system: CMake and Makefile

Requirements

To build and run esh, you need:

  • Windows (Win32 API required)
  • LLVM Clang (clang-cl) (as the C/C++ compiler)
  • CMake
  • Make
  • A Windows environment capable of building Win32 applications

esh relies directly on the Windows API and is not portable to other platforms.

Build & Run

From the project root directory:

make # make configures and generates build file of the project using CMake and Clang
make run # compiles the project and generates esh.exe

Project Status

This project is feature-complete and not under active development. The repository is preserved as a reference and learning artifact.

Versioning

Current version: 0.1.0

License

Licensed under the Apache License 2.0.
See the LICENSE file for details.

Disclaimer

esh is an educational and experimental project. It is not intended for production use. You may encounter bugs while working with esh.

Author

Habil Eren Türker

About

esh (Easy Shell) is an experimental command-line shell written in modern C++ for Windows. This repository is made with the help of AI to understand the Windows API and learning how to write a shell.

Topics

cmakecppeducational-projectexperimentalprojectshellwindows

Resources

Readme
Apache-2.0 license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content

This repository was archived by the owner on Aug 26, 2026. It is now read-only.

BranchesTags
Repository files navigation
esh — Easy Shell for Windows
esh (Easy Shell) is an experimental command-line shell written in modern C++
for Windows.
The project focuses on understanding shell internals, command
execution flow, and Windows API–based system programming rather than providing a
fully featured production shell.
esh is a completed learning-oriented systems programming project.
Goals
  • Understand how a shell parses and executes commands
  • Learn Windows API fundamentals relevant to process and file management
  • Design a clean internal command/flag/symbol architecture
  • Gain experience with Unicode handling (UTF-8 / UTF-16) on Windows
  • Build a non-trivial C++ project with clear structure and layering
Features
  • Built-in commands (file, process, system, and shell commands)
  • Command grouping and internal command registry
  • Flag-based command behavior
  • Pipeline and redirection parsing
  • JSON-based help system
  • Unicode-safe input and output
  • Colored console output
Project Structure
esh/
├─ src/
│ ├─ core/ # Core shell engine (parser, lexer, execution flow)
│ ├─ commands/ # Built-in command implementations
│ ├─ execution/ # Command execution and process control
│ ├─ file/ # File-related commands and utilities
│ ├─ process/ # Process-related commands
│ ├─ env/ # Environment-related commands
│ ├─ shell/ # Shell-specific commands and logic
│ ├─ system/ # System information and system commands
│ ├─ history/ # Command history management
│ ├─ platform/ # Platform-specific utilities (Windows)
│ ├─ headers/ # Public headers and shared interfaces
│ ├─ external/ # Third-party headers (e.g. JSON)
│ └─ consoleOperations # Console-related operations
│
├─ resources.rc # Embeds json file to .exe
├─ app.rc # Windows resource file
├─ icon/esh.ico # Application icon
│
├─ build/ # Build output (not tracked)
├─ esh.json # Command help and metadata
├─ CMakeLists.txt # CMake configuration
├─ Makefile # Build entry point
├─ README.md
└─ LICENSE

Build Information
  • Language: C++ (modern standard)
  • Compiler: LLVM Clang (Windows)
  • Platform: Windows (Win32 API)
  • Encoding: UTF-16 internally, UTF-8 at boundaries
  • Build system: CMake and Makefile
Requirements
To build and run esh, you need:
  • Windows (Win32 API required)
  • LLVM Clang (clang-cl) (as the C/C++ compiler)
  • CMake
  • Make
  • A Windows environment capable of building Win32 applications
esh relies directly on the Windows API and is not portable to other platforms.
Build & Run
From the project root directory:
make # make configures and generates build file of the project using CMake and Clang
make run # compiles the project and generates esh.exe
Project Status
This project is feature-complete and not under active development.
The repository is preserved as a reference and learning artifact.
Versioning
Current version: 0.1.0
License
Licensed under the Apache License 2.0.

See the LICENSE file for details.
Disclaimer
esh is an educational and experimental project.
It is not intended for production use.
You may encounter bugs while working with esh.
Author
Habil Eren Türker
About
esh (Easy Shell) is an experimental command-line shell written in modern C++ for Windows. This repository is made with the help of AI to understand the Windows API and learning how to write a shell.
Topics
cmakecppeducational-projectexperimentalprojectshellwindows
Resources
Readme
Apache-2.0 license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content

This repository was archived by the owner on Aug 26, 2026. It is now read-only.

BranchesTags
Repository files navigation
esh — Easy Shell for Windows
esh (Easy Shell) is an experimental command-line shell written in modern C++
for Windows.
The project focuses on understanding shell internals, command
execution flow, and Windows API–based system programming rather than providing a
fully featured production shell.
esh is a completed learning-oriented systems programming project.
Goals
  • Understand how a shell parses and executes commands
  • Learn Windows API fundamentals relevant to process and file management
  • Design a clean internal command/flag/symbol architecture
  • Gain experience with Unicode handling (UTF-8 / UTF-16) on Windows
  • Build a non-trivial C++ project with clear structure and layering
Features
  • Built-in commands (file, process, system, and shell commands)
  • Command grouping and internal command registry
  • Flag-based command behavior
  • Pipeline and redirection parsing
  • JSON-based help system
  • Unicode-safe input and output
  • Colored console output
Project Structure
esh/
├─ src/
│ ├─ core/ # Core shell engine (parser, lexer, execution flow)
│ ├─ commands/ # Built-in command implementations
│ ├─ execution/ # Command execution and process control
│ ├─ file/ # File-related commands and utilities
│ ├─ process/ # Process-related commands
│ ├─ env/ # Environment-related commands
│ ├─ shell/ # Shell-specific commands and logic
│ ├─ system/ # System information and system commands
│ ├─ history/ # Command history management
│ ├─ platform/ # Platform-specific utilities (Windows)
│ ├─ headers/ # Public headers and shared interfaces
│ ├─ external/ # Third-party headers (e.g. JSON)
│ └─ consoleOperations # Console-related operations
│
├─ resources.rc # Embeds json file to .exe
├─ app.rc # Windows resource file
├─ icon/esh.ico # Application icon
│
├─ build/ # Build output (not tracked)
├─ esh.json # Command help and metadata
├─ CMakeLists.txt # CMake configuration
├─ Makefile # Build entry point
├─ README.md
└─ LICENSE

Build Information
  • Language: C++ (modern standard)
  • Compiler: LLVM Clang (Windows)
  • Platform: Windows (Win32 API)
  • Encoding: UTF-16 internally, UTF-8 at boundaries
  • Build system: CMake and Makefile
Requirements
To build and run esh, you need:
  • Windows (Win32 API required)
  • LLVM Clang (clang-cl) (as the C/C++ compiler)
  • CMake
  • Make
  • A Windows environment capable of building Win32 applications
esh relies directly on the Windows API and is not portable to other platforms.
Build & Run
From the project root directory:
make # make configures and generates build file of the project using CMake and Clang
make run # compiles the project and generates esh.exe
Project Status
This project is feature-complete and not under active development.
The repository is preserved as a reference and learning artifact.
Versioning
Current version: 0.1.0
License
Licensed under the Apache License 2.0.

See the LICENSE file for details.
Disclaimer
esh is an educational and experimental project.
It is not intended for production use.
You may encounter bugs while working with esh.
Author
Habil Eren Türker
About
esh (Easy Shell) is an experimental command-line shell written in modern C++ for Windows. This repository is made with the help of AI to understand the Windows API and learning how to write a shell.
Topics
cmakecppeducational-projectexperimentalprojectshellwindows
Resources
Readme
Apache-2.0 license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content

This repository was archived by the owner on Aug 26, 2026. It is now read-only.

BranchesTags
Repository files navigation
esh — Easy Shell for Windows
esh (Easy Shell) is an experimental command-line shell written in modern C++
for Windows.
The project focuses on understanding shell internals, command
execution flow, and Windows API–based system programming rather than providing a
fully featured production shell.
esh is a completed learning-oriented systems programming project.
Goals
  • Understand how a shell parses and executes commands
  • Learn Windows API fundamentals relevant to process and file management
  • Design a clean internal command/flag/symbol architecture
  • Gain experience with Unicode handling (UTF-8 / UTF-16) on Windows
  • Build a non-trivial C++ project with clear structure and layering
Features
  • Built-in commands (file, process, system, and shell commands)
  • Command grouping and internal command registry
  • Flag-based command behavior
  • Pipeline and redirection parsing
  • JSON-based help system
  • Unicode-safe input and output
  • Colored console output
Project Structure
esh/
├─ src/
│ ├─ core/ # Core shell engine (parser, lexer, execution flow)
│ ├─ commands/ # Built-in command implementations
│ ├─ execution/ # Command execution and process control
│ ├─ file/ # File-related commands and utilities
│ ├─ process/ # Process-related commands
│ ├─ env/ # Environment-related commands
│ ├─ shell/ # Shell-specific commands and logic
│ ├─ system/ # System information and system commands
│ ├─ history/ # Command history management
│ ├─ platform/ # Platform-specific utilities (Windows)
│ ├─ headers/ # Public headers and shared interfaces
│ ├─ external/ # Third-party headers (e.g. JSON)
│ └─ consoleOperations # Console-related operations
│
├─ resources.rc # Embeds json file to .exe
├─ app.rc # Windows resource file
├─ icon/esh.ico # Application icon
│
├─ build/ # Build output (not tracked)
├─ esh.json # Command help and metadata
├─ CMakeLists.txt # CMake configuration
├─ Makefile # Build entry point
├─ README.md
└─ LICENSE

Build Information
  • Language: C++ (modern standard)
  • Compiler: LLVM Clang (Windows)
  • Platform: Windows (Win32 API)
  • Encoding: UTF-16 internally, UTF-8 at boundaries
  • Build system: CMake and Makefile
Requirements
To build and run esh, you need:
  • Windows (Win32 API required)
  • LLVM Clang (clang-cl) (as the C/C++ compiler)
  • CMake
  • Make
  • A Windows environment capable of building Win32 applications
esh relies directly on the Windows API and is not portable to other platforms.
Build & Run
From the project root directory:
make # make configures and generates build file of the project using CMake and Clang
make run # compiles the project and generates esh.exe
Project Status
This project is feature-complete and not under active development.
The repository is preserved as a reference and learning artifact.
Versioning
Current version: 0.1.0
License
Licensed under the Apache License 2.0.

See the LICENSE file for details.
Disclaimer
esh is an educational and experimental project.
It is not intended for production use.
You may encounter bugs while working with esh.
Author
Habil Eren Türker
About
esh (Easy Shell) is an experimental command-line shell written in modern C++ for Windows. This repository is made with the help of AI to understand the Windows API and learning how to write a shell.
Topics
cmakecppeducational-projectexperimentalprojectshellwindows
Resources
Readme
Apache-2.0 license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content

This repository was archived by the owner on Aug 26, 2026. It is now read-only.

BranchesTags
Repository files navigation
esh — Easy Shell for Windows
esh (Easy Shell) is an experimental command-line shell written in modern C++
for Windows.
The project focuses on understanding shell internals, command
execution flow, and Windows API–based system programming rather than providing a
fully featured production shell.
esh is a completed learning-oriented systems programming project.
Goals
  • Understand how a shell parses and executes commands
  • Learn Windows API fundamentals relevant to process and file management
  • Design a clean internal command/flag/symbol architecture
  • Gain experience with Unicode handling (UTF-8 / UTF-16) on Windows
  • Build a non-trivial C++ project with clear structure and layering
Features
  • Built-in commands (file, process, system, and shell commands)
  • Command grouping and internal command registry
  • Flag-based command behavior
  • Pipeline and redirection parsing
  • JSON-based help system
  • Unicode-safe input and output
  • Colored console output
Project Structure
esh/
├─ src/
│ ├─ core/ # Core shell engine (parser, lexer, execution flow)
│ ├─ commands/ # Built-in command implementations
│ ├─ execution/ # Command execution and process control
│ ├─ file/ # File-related commands and utilities
│ ├─ process/ # Process-related commands
│ ├─ env/ # Environment-related commands
│ ├─ shell/ # Shell-specific commands and logic
│ ├─ system/ # System information and system commands
│ ├─ history/ # Command history management
│ ├─ platform/ # Platform-specific utilities (Windows)
│ ├─ headers/ # Public headers and shared interfaces
│ ├─ external/ # Third-party headers (e.g. JSON)
│ └─ consoleOperations # Console-related operations
│
├─ resources.rc # Embeds json file to .exe
├─ app.rc # Windows resource file
├─ icon/esh.ico # Application icon
│
├─ build/ # Build output (not tracked)
├─ esh.json # Command help and metadata
├─ CMakeLists.txt # CMake configuration
├─ Makefile # Build entry point
├─ README.md
└─ LICENSE

Build Information
  • Language: C++ (modern standard)
  • Compiler: LLVM Clang (Windows)
  • Platform: Windows (Win32 API)
  • Encoding: UTF-16 internally, UTF-8 at boundaries
  • Build system: CMake and Makefile
Requirements
To build and run esh, you need:
  • Windows (Win32 API required)
  • LLVM Clang (clang-cl) (as the C/C++ compiler)
  • CMake
  • Make
  • A Windows environment capable of building Win32 applications
esh relies directly on the Windows API and is not portable to other platforms.
Build & Run
From the project root directory:
make # make configures and generates build file of the project using CMake and Clang
make run # compiles the project and generates esh.exe
Project Status
This project is feature-complete and not under active development.
The repository is preserved as a reference and learning artifact.
Versioning
Current version: 0.1.0
License
Licensed under the Apache License 2.0.

See the LICENSE file for details.
Disclaimer
esh is an educational and experimental project.
It is not intended for production use.
You may encounter bugs while working with esh.
Author
Habil Eren Türker
About
esh (Easy Shell) is an experimental command-line shell written in modern C++ for Windows. This repository is made with the help of AI to understand the Windows API and learning how to write a shell.
Topics
cmakecppeducational-projectexperimentalprojectshellwindows
Resources
Readme
Apache-2.0 license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content

This repository was archived by the owner on Aug 26, 2026. It is now read-only.

BranchesTags
Repository files navigation
esh — Easy Shell for Windows
esh (Easy Shell) is an experimental command-line shell written in modern C++
for Windows.
The project focuses on understanding shell internals, command
execution flow, and Windows API–based system programming rather than providing a
fully featured production shell.
esh is a completed learning-oriented systems programming project.
Goals
  • Understand how a shell parses and executes commands
  • Learn Windows API fundamentals relevant to process and file management
  • Design a clean internal command/flag/symbol architecture
  • Gain experience with Unicode handling (UTF-8 / UTF-16) on Windows
  • Build a non-trivial C++ project with clear structure and layering
Features
  • Built-in commands (file, process, system, and shell commands)
  • Command grouping and internal command registry
  • Flag-based command behavior
  • Pipeline and redirection parsing
  • JSON-based help system
  • Unicode-safe input and output
  • Colored console output
Project Structure
esh/
├─ src/
│ ├─ core/ # Core shell engine (parser, lexer, execution flow)
│ ├─ commands/ # Built-in command implementations
│ ├─ execution/ # Command execution and process control
│ ├─ file/ # File-related commands and utilities
│ ├─ process/ # Process-related commands
│ ├─ env/ # Environment-related commands
│ ├─ shell/ # Shell-specific commands and logic
│ ├─ system/ # System information and system commands
│ ├─ history/ # Command history management
│ ├─ platform/ # Platform-specific utilities (Windows)
│ ├─ headers/ # Public headers and shared interfaces
│ ├─ external/ # Third-party headers (e.g. JSON)
│ └─ consoleOperations # Console-related operations
│
├─ resources.rc # Embeds json file to .exe
├─ app.rc # Windows resource file
├─ icon/esh.ico # Application icon
│
├─ build/ # Build output (not tracked)
├─ esh.json # Command help and metadata
├─ CMakeLists.txt # CMake configuration
├─ Makefile # Build entry point
├─ README.md
└─ LICENSE

Build Information
  • Language: C++ (modern standard)
  • Compiler: LLVM Clang (Windows)
  • Platform: Windows (Win32 API)
  • Encoding: UTF-16 internally, UTF-8 at boundaries
  • Build system: CMake and Makefile
Requirements
To build and run esh, you need:
  • Windows (Win32 API required)
  • LLVM Clang (clang-cl) (as the C/C++ compiler)
  • CMake
  • Make
  • A Windows environment capable of building Win32 applications
esh relies directly on the Windows API and is not portable to other platforms.
Build & Run
From the project root directory:
make # make configures and generates build file of the project using CMake and Clang
make run # compiles the project and generates esh.exe
Project Status
This project is feature-complete and not under active development.
The repository is preserved as a reference and learning artifact.
Versioning
Current version: 0.1.0
License
Licensed under the Apache License 2.0.

See the LICENSE file for details.
Disclaimer
esh is an educational and experimental project.
It is not intended for production use.
You may encounter bugs while working with esh.
Author
Habil Eren Türker
About
esh (Easy Shell) is an experimental command-line shell written in modern C++ for Windows. This repository is made with the help of AI to understand the Windows API and learning how to write a shell.
Topics
cmakecppeducational-projectexperimentalprojectshellwindows
Resources
Readme
Apache-2.0 license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content

This repository was archived by the owner on Aug 26, 2026. It is now read-only.

BranchesTags
Repository files navigation
esh — Easy Shell for Windows
esh (Easy Shell) is an experimental command-line shell written in modern C++
for Windows.
The project focuses on understanding shell internals, command
execution flow, and Windows API–based system programming rather than providing a
fully featured production shell.
esh is a completed learning-oriented systems programming project.
Goals
  • Understand how a shell parses and executes commands
  • Learn Windows API fundamentals relevant to process and file management
  • Design a clean internal command/flag/symbol architecture
  • Gain experience with Unicode handling (UTF-8 / UTF-16) on Windows
  • Build a non-trivial C++ project with clear structure and layering
Features
  • Built-in commands (file, process, system, and shell commands)
  • Command grouping and internal command registry
  • Flag-based command behavior
  • Pipeline and redirection parsing
  • JSON-based help system
  • Unicode-safe input and output
  • Colored console output
Project Structure
esh/
├─ src/
│ ├─ core/ # Core shell engine (parser, lexer, execution flow)
│ ├─ commands/ # Built-in command implementations
│ ├─ execution/ # Command execution and process control
│ ├─ file/ # File-related commands and utilities
│ ├─ process/ # Process-related commands
│ ├─ env/ # Environment-related commands
│ ├─ shell/ # Shell-specific commands and logic
│ ├─ system/ # System information and system commands
│ ├─ history/ # Command history management
│ ├─ platform/ # Platform-specific utilities (Windows)
│ ├─ headers/ # Public headers and shared interfaces
│ ├─ external/ # Third-party headers (e.g. JSON)
│ └─ consoleOperations # Console-related operations
│
├─ resources.rc # Embeds json file to .exe
├─ app.rc # Windows resource file
├─ icon/esh.ico # Application icon
│
├─ build/ # Build output (not tracked)
├─ esh.json # Command help and metadata
├─ CMakeLists.txt # CMake configuration
├─ Makefile # Build entry point
├─ README.md
└─ LICENSE

Build Information
  • Language: C++ (modern standard)
  • Compiler: LLVM Clang (Windows)
  • Platform: Windows (Win32 API)
  • Encoding: UTF-16 internally, UTF-8 at boundaries
  • Build system: CMake and Makefile
Requirements
To build and run esh, you need:
  • Windows (Win32 API required)
  • LLVM Clang (clang-cl) (as the C/C++ compiler)
  • CMake
  • Make
  • A Windows environment capable of building Win32 applications
esh relies directly on the Windows API and is not portable to other platforms.
Build & Run
From the project root directory:
make # make configures and generates build file of the project using CMake and Clang
make run # compiles the project and generates esh.exe
Project Status
This project is feature-complete and not under active development.
The repository is preserved as a reference and learning artifact.
Versioning
Current version: 0.1.0
License
Licensed under the Apache License 2.0.

See the LICENSE file for details.
Disclaimer
esh is an educational and experimental project.
It is not intended for production use.
You may encounter bugs while working with esh.
Author
Habil Eren Türker
About
esh (Easy Shell) is an experimental command-line shell written in modern C++ for Windows. This repository is made with the help of AI to understand the Windows API and learning how to write a shell.
Topics
cmakecppeducational-projectexperimentalprojectshellwindows
Resources
Readme
Apache-2.0 license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content

This repository was archived by the owner on Aug 26, 2026. It is now read-only.

BranchesTags
Repository files navigation
esh — Easy Shell for Windows
esh (Easy Shell) is an experimental command-line shell written in modern C++
for Windows.
The project focuses on understanding shell internals, command
execution flow, and Windows API–based system programming rather than providing a
fully featured production shell.
esh is a completed learning-oriented systems programming project.
Goals
  • Understand how a shell parses and executes commands
  • Learn Windows API fundamentals relevant to process and file management
  • Design a clean internal command/flag/symbol architecture
  • Gain experience with Unicode handling (UTF-8 / UTF-16) on Windows
  • Build a non-trivial C++ project with clear structure and layering
Features
  • Built-in commands (file, process, system, and shell commands)
  • Command grouping and internal command registry
  • Flag-based command behavior
  • Pipeline and redirection parsing
  • JSON-based help system
  • Unicode-safe input and output
  • Colored console output
Project Structure
esh/
├─ src/
│ ├─ core/ # Core shell engine (parser, lexer, execution flow)
│ ├─ commands/ # Built-in command implementations
│ ├─ execution/ # Command execution and process control
│ ├─ file/ # File-related commands and utilities
│ ├─ process/ # Process-related commands
│ ├─ env/ # Environment-related commands
│ ├─ shell/ # Shell-specific commands and logic
│ ├─ system/ # System information and system commands
│ ├─ history/ # Command history management
│ ├─ platform/ # Platform-specific utilities (Windows)
│ ├─ headers/ # Public headers and shared interfaces
│ ├─ external/ # Third-party headers (e.g. JSON)
│ └─ consoleOperations # Console-related operations
│
├─ resources.rc # Embeds json file to .exe
├─ app.rc # Windows resource file
├─ icon/esh.ico # Application icon
│
├─ build/ # Build output (not tracked)
├─ esh.json # Command help and metadata
├─ CMakeLists.txt # CMake configuration
├─ Makefile # Build entry point
├─ README.md
└─ LICENSE

Build Information
  • Language: C++ (modern standard)
  • Compiler: LLVM Clang (Windows)
  • Platform: Windows (Win32 API)
  • Encoding: UTF-16 internally, UTF-8 at boundaries
  • Build system: CMake and Makefile
Requirements
To build and run esh, you need:
  • Windows (Win32 API required)
  • LLVM Clang (clang-cl) (as the C/C++ compiler)
  • CMake
  • Make
  • A Windows environment capable of building Win32 applications
esh relies directly on the Windows API and is not portable to other platforms.
Build & Run
From the project root directory:
make # make configures and generates build file of the project using CMake and Clang
make run # compiles the project and generates esh.exe
Project Status
This project is feature-complete and not under active development.
The repository is preserved as a reference and learning artifact.
Versioning
Current version: 0.1.0
License
Licensed under the Apache License 2.0.

See the LICENSE file for details.
Disclaimer
esh is an educational and experimental project.
It is not intended for production use.
You may encounter bugs while working with esh.
Author
Habil Eren Türker
About
esh (Easy Shell) is an experimental command-line shell written in modern C++ for Windows. This repository is made with the help of AI to understand the Windows API and learning how to write a shell.
Topics
cmakecppeducational-projectexperimentalprojectshellwindows
Resources
Readme
Apache-2.0 license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages