{"id":28725155,"url":"https://github.com/nebuff/aero","last_synced_at":"2025-06-15T11:10:17.371Z","repository":{"id":299134696,"uuid":"1002160479","full_name":"nebuff/aero","owner":"nebuff","description":"A Simple but Intuitive OS For the terminal on ANY, I mean ANY!!! Computers that support Python","archived":false,"fork":false,"pushed_at":"2025-06-14T22:11:32.000Z","size":20,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-14T22:20:39.693Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","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/nebuff.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-06-14T21:05:32.000Z","updated_at":"2025-06-14T22:11:36.000Z","dependencies_parsed_at":"2025-06-14T22:20:41.101Z","dependency_job_id":"fd2af1b2-b33a-45c9-b4b1-90c0ac12707a","html_url":"https://github.com/nebuff/aero","commit_stats":null,"previous_names":["nebuff/aero"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nebuff/aero","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nebuff%2Faero","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nebuff%2Faero/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nebuff%2Faero/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nebuff%2Faero/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nebuff","download_url":"https://codeload.github.com/nebuff/aero/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nebuff%2Faero/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259964315,"owners_count":22938726,"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":[],"created_at":"2025-06-15T11:10:16.733Z","updated_at":"2025-06-15T11:10:17.362Z","avatar_url":"https://github.com/nebuff.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aero\n\nAero is a simple, extensible, and colorful command shell for macOS and Linux, written in Python.  \nIt supports plugins, user configuration, and a friendly installer.\n\n---\n\n## Features\n\n- Basic shell commands: `ls`, `cd`, `mkdir`, `exit`, `quit`\n- Plugin system: install, list, and delete plugins\n- Colorful prompt and output (fully configurable)\n- User configuration: username, color settings, and more\n- Easy installation with our Installer\n- Easy Updating with the handy Updater Plugin!\n\n---\n\n## Installation\n\n1. **Install**\n\n   - Download the install.sh script from the Repo\n\n   \u003e Click on the \"install.sh\" file in files\n   \u003e  then Navigate to the \"Download raw file\" Tab on the top right\n\n   ```sh\n   cd ~/Downloads\n   chmod +x install.sh\n   ./install.sh\n   ```\n\n   \u003e **Note:**  \n   \u003e The installer will guide you through selecting a version and will set up Aero in `~/aero`.\n\n3. **After install:**\n\n   - Open a **new terminal window** or run:\n     ```sh\n     source ~/.zshrc\n     ```\n     or\n     ```sh\n     source ~/.bashrc\n     ```\n   - Now you can launch Aero from anywhere by typing:\n     ```sh\n     aero\n     ```\n---\n\n## Using TUI\n\n  \u003e**Warning**\n  \u003eDoing this could ruin your shell, Proceed with caution\n\n   - Normaly Install Exept install TUI Version only\n   - Make sure you have the Latest Python Version\n   - Install... Just figure it out\n\n---\n\n## Usage\n\nWhen you start Aero, you'll see a colorful prompt and a welcome message with your username.\n\n### Built-in Commands\n\n| Command                | Description                       |\n|------------------------|-----------------------------------|\n| `ls`                   | List files in the current directory |\n| `cd [dir]`             | Change directory                  |\n| `mkdir \u003cdir\u003e`          | Make a new directory              |\n| `exit` or `quit`       | Exit Aero                         |\n| `installist`           | List installed and available plugins |\n| `install \u003cname\u003e`       | Install a plugin by name          |\n| `installdelete \u003cname\u003e` | Delete an installed plugin        |\n| `config`               | Show and change configuration     |\n\n---\n\n## Configuration\n\nAero stores its configuration in `~/aero/config.json`.\n\nYou can view and change settings using the `config` command inside Aero:\n\n- Show all config options:\n  ```\n  config\n  ```\n- Change your username:\n  ```\n  config username YourName\n  ```\n- Turn color on or off:\n  ```\n  config color on\n  config color off\n  ```\n- Change a color (use ANSI codes, e.g. `\\033[35m` for magenta):\n  ```\n  config color prompt \\033[35m\n  config color error \\033[31m\n  ```\n- Show the raw config file:\n  ```\n  config show\n  ```\n\n---\n\n## Plugins\n\n- To see available plugins:\n  ```\n  installist\n  ```\n- To install a plugin:\n  ```\n  install \u003cpluginname\u003e\n  ```\n- To delete a plugin:\n  ```\n  installdelete \u003cpluginname\u003e\n  ```\n\nPlugins are loaded from the `~/aero/plugins` directory at startup.\n\n---\n\n## Troubleshooting\n\n- **Command not found:**  \n  Make sure you opened a new terminal window or sourced your shell config after install.\n- **Wrong Python version:**  \n  The installer sets up Aero to use the correct Python. If you have issues, check your alias in `~/.zshrc` or `~/.bashrc`.\n- **Config not saving:**  \n  Make sure you have write permissions to `~/aero/config.json`.\n\n---\n\n## Uninstall\n\nTo remove Aero, simply delete the `~/aero` directory and remove the `aero` alias from your shell config (`~/.zshrc` or `~/.bashrc`).\n\n---\n\n## License\n\nMIT License\n\n---\n\n## Credits\n\nAero Installer and Shell by Holden  \nSee [https://github.com/nebuff/aero](https://github.com/nebuff/aero) for updates.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnebuff%2Faero","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnebuff%2Faero","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnebuff%2Faero/lists"}