Skip to content
Tanish Poddar edited this page Jun 8, 2025 · 2 revisions

Frequently Asked Questions (FAQ)

About the Developers

Aegis Shell was developed with ❤️ by Tanish Poddar, Nidhi Nayana & Nishant Ranjan.

They are B.Tech students from SRM Institute of Science and Technology (SRMIST), Kattankulathur. This project is a result of their shared interest in systems programming and shell design, aiming to create a lightweight, efficient, and user-friendly shell interface.

Project Repository: github.com/tanishpoddar/aegis-shell

Installation

Do I need Python installed to use Aegis Shell?

No, you don't need Python installed. The release versions are standalone executables that include all necessary dependencies.

The application won't start on Windows

If you encounter security warnings:

  1. Right-click the executable
  2. Select "Properties"
  3. Check "Unblock" if available
  4. Try running as administrator if needed

Troubleshooting

The AI features aren't working

  1. Ensure you have a valid API key set up
  2. Check your internet connection
  3. Verify that OpenRouter's service is available
  4. Try restarting Aegis Shell

Package installation fails

Common solutions:

  1. Ensure you have administrator/sudo privileges
  2. Check your internet connection
  3. Verify that your system's package manager is working
  4. Try running the command with elevated privileges

Security

Is my API key secure?

Yes, your API key is stored locally in your user directory and is never shared or transmitted to any third parties except OpenRouter's API.

Does Aegis Shell collect any data?

Aegis Shell only collects:

  • Anonymous usage statistics (optional)
  • Error reports (optional)
  • No personal data is collected or stored

Support

Where can I get help?

  • GitHub Issues
  • Documentation
  • Community Discussions
  • Wiki Pages

How do I update Aegis Shell?

  1. Download the latest release from GitHub
  2. Replace your existing installation
  3. Your settings and API key will be preserved

Advanced Usage

Can I customize Aegis Shell?

Yes, you can customize:

  • Command mappings
  • UI preferences
  • Package manager preferences
  • AI assistant behavior

How do I add custom command mappings?

Edit the config/commands_mapping.json file:

{
  "custom_command": {
    "language": "python",
    "install_cmd": "pip install package_name"
  }
}