{"id":28796016,"url":"https://github.com/cybiii/powershell","last_synced_at":"2026-05-18T06:12:13.925Z","repository":{"id":296769379,"uuid":"993045265","full_name":"Cybiii/Powershell","owner":"Cybiii","description":"A custom command-line shell for Windows built from scratch in C++, featuring a suite of built-in filesystem and text manipulation commands","archived":false,"fork":false,"pushed_at":"2025-06-12T09:44:57.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-12T09:46:54.491Z","etag":null,"topics":["cmake","cpp","shell"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cybiii.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-30T05:57:48.000Z","updated_at":"2025-06-12T09:45:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"c3b0f2d9-0a8d-4a2f-893a-dc63d84fd725","html_url":"https://github.com/Cybiii/Powershell","commit_stats":null,"previous_names":["cybiii/powershell"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Cybiii/Powershell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cybiii%2FPowershell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cybiii%2FPowershell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cybiii%2FPowershell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cybiii%2FPowershell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cybiii","download_url":"https://codeload.github.com/Cybiii/Powershell/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cybiii%2FPowershell/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260477919,"owners_count":23015068,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cmake","cpp","shell"],"created_at":"2025-06-18T03:10:55.557Z","updated_at":"2026-05-18T06:12:13.872Z","avatar_url":"https://github.com/Cybiii.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shell\r\n\r\nA simple cross-platform shell implemented in C++.\r\n\r\n## Features\r\n\r\n- Executes external commands.\r\n- A suite of built-in commands for filesystem, text, and system information.\r\n- Customizable prompt that displays the current working directory.\r\n- Command history accessible via the `history` command.\r\n- Color-coded and formatted output for commands like `ls` and `pwd`.\r\n- A friendly welcome message on startup.\r\n\r\n## Built-in Commands\r\n\r\n### Filesystem\r\n\r\n| Command           | Description                                             | Usage                          |\r\n| ----------------- | ------------------------------------------------------- | ------------------------------ |\r\n| `ls [path]`       | Lists the contents of a directory in a detailed format. | `ls` or `ls src`               |\r\n| `pwd`             | Prints the current working directory.                   | `pwd`                          |\r\n| `cd [path]`       | Changes the current working directory.                  | `cd src`                       |\r\n| `mkdir [name]`    | Creates a new directory.                                | `mkdir new_folder`             |\r\n| `rm [name]`       | Removes a file or an empty directory.                   | `rm old_file.txt`              |\r\n| `touch [name]`    | Creates an empty file or updates its timestamp.         | `touch new_file.txt`           |\r\n| `cp [src] [dest]` | Copies a file.                                          | `cp file.txt backup.txt`       |\r\n| `mv [src] [dest]` | Moves or renames a file.                                | `mv old_name.txt new_name.txt` |\r\n\r\n### Text Manipulation\r\n\r\n| Command             | Description                                 | Usage                    |\r\n| ------------------- | ------------------------------------------- | ------------------------ |\r\n| `cat [file]`        | Displays the content of a text file.        | `cat README.md`          |\r\n| `grep [pat] [file]` | Searches for a pattern in a text file.      | `grep \"CMake\" README.md` |\r\n| `head [file]`       | Displays the first 10 lines of a text file. | `head README.md`         |\r\n| `head -n 15 [file]` | Displays the first 15 lines of a text file. | `head -n 15 README.md`   |\r\n| `tail [file]`       | Displays the last 10 lines of a text file.  | `tail README.md`         |\r\n| `tail -n 15 [file]` | Displays the last 15 lines of a text file.  | `tail -n 15 README.md`   |\r\n\r\n### System \u0026 Session\r\n\r\n| Command       | Description                                           | Usage                |\r\n| ------------- | ----------------------------------------------------- | -------------------- |\r\n| `history`     | Displays the command history for the current session. | `history`            |\r\n| `date`        | Displays the current date and time.                   | `date`               |\r\n| `hostname`    | Displays the computer name.                           | `hostname`           |\r\n| `echo [text]` | Prints text to the console.                           | `echo Hello, World!` |\r\n| `exit`        | Exits the shell.                                      | `exit`               |\r\n\r\n## Building the Project\r\n\r\nThis project uses CMake to generate build files.\r\n\r\n### Prerequisites\r\n\r\n- A C++17 compliant compiler (e.g., GCC, Clang, MSVC)\r\n- CMake (version 3.10 or later)\r\n\r\n### Build Steps\r\n\r\n1.  **Clone the repository (if you haven't already):**\r\n\r\n    ```bash\r\n    git clone \u003crepository-url\u003e\r\n    cd Powershell\r\n    ```\r\n\r\n2.  **Create a build directory:**\r\n\r\n    ```bash\r\n    mkdir build\r\n    cd build\r\n    ```\r\n\r\n3.  **Configure the project with CMake:**\r\n\r\n    ```bash\r\n    cmake ..\r\n    ```\r\n\r\n4.  **Build the project:**\r\n    - On Windows (with Visual Studio):\r\n      ```bash\r\n      cmake --build . --config Release\r\n      ```\r\n    - On Linux/macOS:\r\n      ```bash\r\n      make\r\n      ```\r\n\r\nThe executable `shell` (or `shell.exe` on Windows) will be created in the `build` directory.\r\n\r\n## Running the Shell\r\n\r\nNavigate to the build directory and run the executable:\r\n\r\n```bash\r\n./shell\r\n```\r\n\r\nOr on Windows:\r\n\r\n```bash\r\n.\\\\shell.exe\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybiii%2Fpowershell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcybiii%2Fpowershell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybiii%2Fpowershell/lists"}