{"id":23048627,"url":"https://github.com/whirlxd/brainrot-shell","last_synced_at":"2026-02-09T06:33:59.557Z","repository":{"id":267130500,"uuid":"900256774","full_name":"whirlxd/brainrot-shell","owner":"whirlxd","description":"A custom toy version of the shell written in python to use brainrot terms","archived":false,"fork":false,"pushed_at":"2024-12-09T17:56:47.000Z","size":43,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-03T03:18:06.866Z","etag":null,"topics":["brainrot","python","shell","skibidi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whirlxd.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}},"created_at":"2024-12-08T09:58:00.000Z","updated_at":"2025-03-11T20:48:30.000Z","dependencies_parsed_at":"2024-12-08T15:30:58.936Z","dependency_job_id":"46aeeee6-39c6-402f-be0a-117513312acb","html_url":"https://github.com/whirlxd/brainrot-shell","commit_stats":null,"previous_names":["whirlxd/brainrot-shell"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whirlxd%2Fbrainrot-shell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whirlxd%2Fbrainrot-shell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whirlxd%2Fbrainrot-shell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whirlxd%2Fbrainrot-shell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whirlxd","download_url":"https://codeload.github.com/whirlxd/brainrot-shell/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whirlxd%2Fbrainrot-shell/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259184740,"owners_count":22818267,"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":["brainrot","python","shell","skibidi"],"created_at":"2024-12-15T22:55:23.497Z","updated_at":"2025-06-11T02:06:23.895Z","avatar_url":"https://github.com/whirlxd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Brainrot Shell\n\nAre you tired of using the same old regular shell? Are you a true skibidi sigma? Introducing **Brainrot Shell**—the new shell that's only for those who know 💀\n\nOriginally built as a CodeCrafters \"Build Your Own X\" challenge, Brainrot Shell has been upgraded to be actually useful with added features.\n\n## Prerequisites\n\n### Operating System\n- **Windows** (untested on other operating systems but should work the same way)\n\n### Python\n- Python 3 installed and added to your system PATH\n\nYou can download Python from the [official Python website](https://www.python.org/).\n\n## Installation\n\nFollow these steps to install Brainrot Shell on your Windows system:\n\n### 1. Download the Brainrot Shell Repository\n\n#### Option 1: Clone the Repository with Git\nIf you have Git installed, you can clone the repository:\n\n```bash\n# Replace `repository-url` with the actual URL of the Brainrot Shell repository\ngit clone https://github.com/whirlxd/brainrot-shell.git\n```\n\n#### Option 2: Download ZIP\n1. Visit the GitHub repository page.\n2. Click on the **\"Code\"** button and select **\"Download ZIP\"**.\n3. Extract the contents to a folder on your computer.\n\n### 2. Run the Installation Script\n\n#### Navigate to the Project Directory\nOpen Command Prompt and navigate to the directory where you saved the Brainrot Shell files:\n\n```bash\ncd path-to-brainrot-shell-folder\n```\n\n#### Run `install.bat`\nExecute the installation script by typing:\n\n```bash\ninstall.bat\n```\n\n\u003e **Note:** You may need to run Command Prompt as an administrator to ensure the script can modify system environment variables.\n\n#### Follow the On-Screen Instructions\nThe script will:\n- Copy `brainrot.py` and the `commands` directory to `%USERPROFILE%\\Scripts`.\n- Add `%USERPROFILE%\\Scripts` to your system PATH if it's not already included.\n- Create a wrapper batch file `brainrot.bat` to run the shell.\n\n#### Restart Command Prompt\nClose all Command Prompt windows and open a new one to apply the changes to your PATH.\n\n## Usage\n\nAfter installation, you can start using Brainrot Shell.\n\n### Starting the Shell\nOpen Command Prompt and type:\n\n```bash\nbrainrot\n```\n\nYou should see the Brainrot Shell prompt:\n\n```\n@brainrot ~$\n```\n\n### Available Commands\nBrainrot Shell is a toy shell but still incredibly useful. Here are some of the commands you can use:\n\n| Command      | Description                                    |\n|--------------|------------------------------------------------|\n| `ragequit`   | Exit the shell.                               |\n| `yap`        | Display a line of text (similar to `echo`).   |\n| `typeshi`       | Display information about command types.   |\n| `pwd`        | Print the current working directory.          |\n| `hawktuah`   | Change the current directory.           |\n| `loot`        | Display file contents.                        |\n| `help`       | Display the help message.                     |\n| `map`         | List files in the current directory.          |\n| `touch`      | Create a new empty file.                      |\n| `spawn`      | Create a new directory.                       |\n| `despawn`      | Remove an empty directory.                    |\n| `unalive`      | Remove a directory w/its contents.          |\n| `wipeout`      | Clear the session        |\n| `fanum`      | View the top 20 processes and their tax (cpu usage)      |\n| `showgyatt`      | Show the files in directory sorted by their size and with it      |\n| `ksi`      | Get ksi to say anything (like cat say).                    |\n| `thickofit`      | Im in the thick of it everybody knows.           |\n\n\n\n\n\n### Examples\n\n#### Display a Message\n```bash\n@brainrot~$ yap \"Hello, Brainrot!\"\n```\n\n#### List Files\n```bash\n@brainrot~$ map\n```\n\n#### Print Working Directory\n```bash\n@brainrot~$ pwd\n```\n\n#### Change Directory\n```bash\n@brainrot~$ hawktuah path/to/directory\n```\n\n#### Create a New File\n```bash\n@brainrot~$ touch newfile.txt\n```\n\n#### Create a New Directory\n```bash\n@brainrot~$ spawn newdirectory\n```\n\n#### Remove a Directory\n```bash\n@brainrot~$ despawn olddirectory\n```\n\n#### Display File Contents\n```bash\n@brainrot~$ loot file.txt\n```\n\n#### Get Help\n```bash\n@brainrot~$ help\n```\n\n### Exiting the Shell\nTo exit Brainrot Shell, type:\n\n```bash\n@brainrot~$ ragequit\n```\n\n## Troubleshooting\n\n### `'brainrot' is not recognized as an internal or external command`\n- Ensure that the installation script ran successfully.\n- Verify that `%USERPROFILE%\\Scripts` is added to your system PATH.\n- Restart Command Prompt to apply the changes to your PATH.\n\n### `ModuleNotFoundError: No module named 'commands'`\n- Ensure that the `commands` directory is located in `%USERPROFILE%\\Scripts`.\n- The `install.bat` script should have copied the `commands` directory. Try running the installation script again.\n\n### `Python is not recognized`\n- Ensure that Python 3.x is installed and added to your system PATH.\n- You can verify by running:\n\n```bash\npython --version\n```\n\n## Uninstallation\n\nTo remove Brainrot Shell from your system:\n\n### Delete Installed Files\nRemove the following from `%USERPROFILE%\\Scripts`:\n- `brainrot.py`\n- `brainrot.bat`\n- `commands` directory\n\n### Remove the Scripts Directory from PATH (Optional)\nIf you added `%USERPROFILE%\\Scripts` to your PATH and no longer need it, you can remove it:\n\n1. Search for **\"Environment Variables\"** in the Start menu.\n2. Select **\"Edit the system environment variables\"**.\n3. Click on **\"Environment Variables\"**.\n4. Under **\"User variables\"** or **\"System variables\"**, find and select PATH.\n5. Click **\"Edit\"** and remove `%USERPROFILE%\\Scripts` from the list.\n\n#### Restart Command Prompt\nClose all Command Prompt windows and open a new one to apply the changes.\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.\n\n## Contributing\nContributions are welcome! Please open an issue or submit a pull request for any improvements. If you have a suggestion for a new name for a command or a new command, feel free to share it through an issue.\n\n## Acknowledgements\nInspired by the CodeCrafters \"Build Your Own X\" challenge. The readme was made with help of chatgpt 💀.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhirlxd%2Fbrainrot-shell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhirlxd%2Fbrainrot-shell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhirlxd%2Fbrainrot-shell/lists"}