{"id":24307745,"url":"https://github.com/2501-ai/supershell","last_synced_at":"2025-04-07T11:09:54.109Z","repository":{"id":272443921,"uuid":"904151077","full_name":"2501-ai/supershell","owner":"2501-ai","description":"The supershell: the shell of the future powered by AI","archived":false,"fork":false,"pushed_at":"2025-01-24T10:29:26.000Z","size":3810,"stargazers_count":83,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-31T10:05:31.779Z","etag":null,"topics":["agentic-ai","ai","bash","shell","terminal","zsh"],"latest_commit_sha":null,"homepage":"https://2501.ai/","language":"Shell","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/2501-ai.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-16T10:50:37.000Z","updated_at":"2025-03-22T22:15:45.000Z","dependencies_parsed_at":"2025-01-24T11:22:01.084Z","dependency_job_id":null,"html_url":"https://github.com/2501-ai/supershell","commit_stats":null,"previous_names":["2501-ai/supershell"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2501-ai%2Fsupershell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2501-ai%2Fsupershell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2501-ai%2Fsupershell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2501-ai%2Fsupershell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/2501-ai","download_url":"https://codeload.github.com/2501-ai/supershell/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247640465,"owners_count":20971557,"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":["agentic-ai","ai","bash","shell","terminal","zsh"],"created_at":"2025-01-17T04:19:27.007Z","updated_at":"2025-04-07T11:09:54.080Z","avatar_url":"https://github.com/2501-ai.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Supershell\n\n## Overview\n\nThe Supershell is an innovative tool designed to enhance your terminal experience by providing intelligent command suggestions and system information. This project aims to streamline your workflow and improve productivity for developers and power users alike.\n\n![Command Suggestions](https://github.com/2501-ai/supershell/blob/main/ai_responses.gif)\n\n## Table of Contents\n\n- [The Supershell](#supershell)\n  - [Overview](#overview)\n  - [Table of Contents](#table-of-contents)\n  - [Features](#features)\n  - [Installation](#installation)\n    - [Requirements](#requirements)\n    - [Automatic Installation](#automatic-installation)\n    - [Manual Installation](#manual-installation)\n  - [Getting Started](#getting-started)\n  - [Examples](#examples)\n    - [Example 1: Command Suggestions](#example-1-command-suggestions)\n    - [Example 2: Autonomous Agent Suggestions](#example-2-autonomous-agent-suggestions)\n  - [Contributing](#contributing)\n  - [Troubleshooting](#troubleshooting)\n  - [Support](#support)\n  - [License](#license)\n\n## Features\n\n- **Intelligent Command Suggestions**: Get context-aware suggestions as you type.\n- **Autonomous Agent**: Activate an AI-powered suggestion mode for enhanced assistance.\n- **System Information**: Display RAM and CPU details directly in your terminal.\n- **Customizable**: Easily configure settings to suit your workflow.\n\n## Installation\n\n### Requirements\n\n- **MacOS 14.0+** (Linux support coming soon)\n- **zsh** (Support for bash and fish coming soon)\n\n### Automatic Installation\n\nRun the following command to automatically install the tool:\n\n```bash\ncurl -sL https://raw.githubusercontent.com/2501-ai/supershell/refs/heads/main/install.sh | zsh\n```\n\n### Manual Installation\n\n1. Clone this repository or download the project files:\n   ```bash\n   git clone git@github.com:2501-ai/supershell.git \"$HOME/.supershell\"\n   ```\n2. Ensure the `main.sh` file has execution permissions:\n   ```bash\n   chmod +x main.sh\n   ```\n3. Add the source command to your shell's configuration file (`.bashrc`, `.zshrc`, etc.):\n   ```bash\n   echo \"source $HOME/.supershell/main.sh\" \u003e\u003e ~/.$(basename $SHELL)rc\n   ```\n4. Source the `main.sh` file in your current terminal session to activate SuperShell:\n   ```bash\n   source \"$HOME/.supershell/main.sh\"\n   ```\n\n## Getting Started\n\nTo start using the tool:\n\n1. Open your terminal.\n2. Begin typing your command.\n3. write something and it will show you suggestions :\n   - Select a suggestion and press Enter to execute it.\n   - Start the autonomous agent suggestion by pressing `Ctrl + J`.\n\n**Important Notes:**\n- The tool must be sourced (not executed) to function properly.\n- To automatically load it on terminal startup, add the source command to your shell's configuration file.\n\n## Examples\n\nHere are some examples of how to use the tool effectively:\n\n### Example 1: Command Suggestions\n\n![Command Suggestions](https://github.com/2501-ai/supershell/blob/main/ai_responses.gif)\n\nIn this example, you can see how the tool provides command suggestions as you type. Simply press the down arrow key to navigate through the suggestions.\n\n### Example 2: Autonomous Agent Suggestions\n\n![Autonomous Agent Suggestions](https://github.com/2501-ai/supershell/blob/main/natural_language.gif)\n\nThis GIF demonstrates how to start the autonomous agent suggestion by pressing `Ctrl + J`. The agent will provide context-aware suggestions based on your input.\n\n## Contributing\n\nWe welcome contributions from the community! To contribute to the Shell Project, please follow these steps:\n\n1. **Fork the repository**.\n2. **Create your feature branch**:\n   ```bash\n   git checkout -b feature/AmazingFeature\n   ```\n3. **Commit your changes**:\n   ```bash\n   git commit -m 'Add some AmazingFeature'\n   ```\n4. **Push to the branch**:\n   ```bash\n   git push origin feature/AmazingFeature\n   ```\n5. **Open a Pull Request**.\n\nFor major changes, please open an issue first to discuss your ideas.\n\n## Troubleshooting\n\nIf the tool is not working as expected, please verify:\n\n- The file has proper execution permissions.\n- You are using the `source` command (or `.`) and not trying to execute the file directly.\n- You are in the correct directory when sourcing the file.\n- Your shell is compatible (Bash and Zsh are supported).\n- Set the environment variable `export SUPERSHELL_DEBUG=true` to see debug logs (in `/tmp/2501/logs/supershell.log` file).\n\n## Support\n\nIf you encounter any issues or have questions, feel free to join our Discord server at [Discord Link](https://discord.gg/uuCma4eHBF) or open an issue on GitHub [GitHub Link](https://github.com/2501-ai/supershell).\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for more details.\n\n---\n\nThank you for checking out the Shell Project! We hope you find it useful and look forward to your contributions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2501-ai%2Fsupershell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F2501-ai%2Fsupershell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2501-ai%2Fsupershell/lists"}