OpenSH v0.3.0

OpenSH 0.3.0: a safety guard for generated commands.

What's new

• Safety guard: commands that delete data (rm -rf, del /s, Remove-Item -Recurse), write to disks (mkfs, format, dd of=), rewrite git history (push --force, reset --hard, clean -f), pipe a download into a shell, or shut the machine down now show a red [y/N] prompt before they run, in the interactive shell and with -c.
• -y/--yes skips the prompt for scripted use.
• Tests for the guard (tests/test_safety.py) run in CI on Windows, macOS and Linux with Python 3.9, 3.11 and 3.12.
• New README with banner and logo, usage, safety, configuration, architecture, development and troubleshooting sections.
• Links, installers and the update check point at muhib-karim/OpenSH.

Install

Platform
Windows	irm https://raw.githubusercontent.com/muhib-karim/OpenSH/main/install.ps1 | iex or opsh-windows.zip
macOS	curl -fsSL https://raw.githubusercontent.com/muhib-karim/OpenSH/main/install.sh | bash or opsh-macos.tar.gz
Linux	same script, or opsh-linux.tar.gz

The binaries are single-file PyInstaller builds made by the release workflow on this tag.

OpenSH v0.2.0

Full Changelog: v0.1.1...v0.2.0

OpenSH v0.1.1

Quick query mode with 'ask' command. Simplified API key setup.

OpenSH v0.1.0 - Google Account Sign-in

🚀 OpenSH v0.1.0 - Google Account Sign-in

What's New

🔐 Google Account Authentication

Now you can sign in with your Google account instead of manually copying API keys!

On first launch, you'll see:

🔐 OpenSH Authentication

How would you like to authenticate?

  1. Google Account (recommended)
     Sign in with your Google account - no API key needed

  2. Custom API Key
     Use your own Gemini API key from aistudio.google.com

Option 1: Opens your browser → sign in with Google → done!
Option 2: Paste your own API key (free from aistudio.google.com)

🔄 Switch Auth Anytime

Use !auth to change your authentication method at any time.

One-Liner Install

Windows (PowerShell)

irm https://raw.githubusercontent.com/ai-dev-2024/OpenSH/main/install.ps1 | iex

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/ai-dev-2024/OpenSH/main/install.sh | bash

Requirements

• Python 3.8+
• A Google account (for OAuth) OR a free Gemini API key

---

See CHANGELOG.md for full details.

☕ Support: https://ko-fi.com/ai_dev_2024

OpenSH v0.0.2

🚀 OpenSH v0.0.2 - Authentication Improvements

What's New

🔐 Authentication Menu

• Interactive first-run setup with authentication options
• Choose between API Key (works now) or Google OAuth (coming soon)
• Cleaner, friendlier setup experience

🔒 Security

• Credential files now properly excluded from git
• OAuth preparation with google-auth-oauthlib dependency

Installation

Windows (PowerShell)

git clone https://github.com/ai-dev-2024/OpenSH.git && cd OpenSH && .\install.ps1

macOS / Linux

git clone https://github.com/ai-dev-2024/OpenSH.git && cd OpenSH && bash install.sh

Requirements

• Python 3.8+
• Free Google Gemini API key

---

See CHANGELOG.md for full details.

☕ Support: https://ko-fi.com/ai_dev_2024

OpenSH v0.0.1

🚀 OpenSH v0.0.1 - Initial Release

The first public release of OpenSH - a multi-platform natural language shell.

✨ Features

• 🌍 Multi-Platform - Windows, macOS, and Linux support
• 🤖 AI-Powered - Uses Google Gemini to translate natural language to shell commands
• ⚡ Smart Detection - Recognizes 50+ shell commands and runs them directly
• 🔄 Context-Aware - Remembers command history for better suggestions
• 💻 Platform-Native - Generates PowerShell on Windows, bash/zsh on Unix

📦 Installation

Windows (PowerShell)

git clone https://github.com/ai-dev-2024/OpenSH.git && cd OpenSH && .\install.ps1

macOS / Linux

git clone https://github.com/ai-dev-2024/OpenSH.git && cd OpenSH && bash install.sh

📋 Requirements

• Python 3.8+
• Free Google Gemini API key

---

See CHANGELOG.md for full details.

☕ Support: https://ko-fi.com/ai_dev_2024

Based on nlsh by Junaid Mahmood