Supershell

Overview

The 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.

Table of Contents

• The Supershell
  • Overview
  • Table of Contents
  • Features
  • Installation
    • Requirements
    • Automatic Installation
    • Manual Installation
  • Getting Started
  • Examples
    • Example 1: Command Suggestions
    • Example 2: Autonomous Agent Suggestions
  • Contributing
  • Troubleshooting
  • Support
  • License

Features

• Intelligent Command Suggestions: Get context-aware suggestions as you type.
• Autonomous Agent: Activate an AI-powered suggestion mode for enhanced assistance.
• System Information: Display RAM and CPU details directly in your terminal.
• Customizable: Easily configure settings to suit your workflow.

Installation

Requirements

• MacOS 14.0+ (Linux support coming soon)
• zsh (Support for bash and fish coming soon)

Automatic Installation

Run the following command to automatically install the tool:

curl -sL https://raw.githubusercontent.com/2501-ai/supershell/refs/heads/main/install.sh | zsh

Manual Installation

1. Clone this repository or download the project files:

   git clone [email protected]:2501-ai/supershell.git "$HOME/.supershell"

2. Ensure the main.sh file has execution permissions:

   chmod +x main.sh

3. Add the source command to your shell's configuration file (.bashrc, .zshrc, etc.):

   echo "source $HOME/.supershell/main.sh" >> ~/.$(basename $SHELL)rc

4. Source the main.sh file in your current terminal session to activate SuperShell:

   source "$HOME/.supershell/main.sh"

Getting Started

To start using the tool:

1. Open your terminal.
2. Begin typing your command.
3. write something and it will show you suggestions :
   • Select a suggestion and press Enter to execute it.
   • Start the autonomous agent suggestion by pressing Ctrl + J.

Important Notes:

• The tool must be sourced (not executed) to function properly.
• To automatically load it on terminal startup, add the source command to your shell's configuration file.

Examples

Here are some examples of how to use the tool effectively:

Example 1: Command Suggestions

In 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.

Example 2: Autonomous Agent Suggestions

This GIF demonstrates how to start the autonomous agent suggestion by pressing Ctrl + J. The agent will provide context-aware suggestions based on your input.

Contributing

We welcome contributions from the community! To contribute to the Shell Project, please follow these steps:

1. Fork the repository.
2. Create your feature branch:

   git checkout -b feature/AmazingFeature

3. Commit your changes:

   git commit -m 'Add some AmazingFeature'

4. Push to the branch:

   git push origin feature/AmazingFeature

5. Open a Pull Request.

For major changes, please open an issue first to discuss your ideas.

Troubleshooting

If the tool is not working as expected, please verify:

• The file has proper execution permissions.
• You are using the source command (or .) and not trying to execute the file directly.
• You are in the correct directory when sourcing the file.
• Your shell is compatible (Bash and Zsh are supported).
• Set the environment variable export SUPERSHELL_DEBUG=true to see debug logs (in /tmp/2501/logs/supershell.log file).

Support

If you encounter any issues or have questions, feel free to join our Discord server at Discord Link or open an issue on GitHub GitHub Link.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

Thank you for checking out the Shell Project! We hope you find it useful and look forward to your contributions.