Metadata-Version: 2.4
Name: star-shell
Version: 0.4.0
Summary: AI-powered command line assistant that generates and executes shell commands
Author-email: Daniel Xu <imperialkoi9@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/ImperialKoi/Star-Shell
Project-URL: Repository, https://github.com/ImperialKoi/Star-Shell
Project-URL: Issues, https://github.com/ImperialKoi/Star-Shell/issues
Keywords: cli,ai,shell,command-line,assistant,automation,star-shell
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Shells
Classifier: Topic :: Utilities
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: google-generativeai>=0.3.0
Requires-Dist: openai
Requires-Dist: requests
Requires-Dist: typer
Requires-Dist: rich
Requires-Dist: pyperclip
Requires-Dist: cryptography
Dynamic: license-file

# ⭐ Star Shell

An AI-powered command line assistant that generates and executes shell commands using natural language.

## Features

- 🤖 **AI-Powered**: Uses OpenAI GPT or Google Gemini to understand your requests
- 💬 **Interactive Terminal**: Natural conversation with command execution
- 🧠 **Smart Responses**: AI decides whether to run commands or provide information
- 🔄 **Multi-Command Support**: Execute multiple commands in sequence automatically
- 🛡️ **Safety First**: Built-in command safety checks and confirmations
- 🎯 **Context Aware**: Understands your current directory and system environment
- 🔒 **Secure**: Encrypted API key storage
- 🎨 **Beautiful Output**: Rich formatting and syntax highlighting
- ⚡ **Streamlined UX**: Automatic initialization checks and intuitive commands

## Installation

```bash
pip install star-shell
```

## Quick Start

1. **First time setup**:
   ```bash
   star-shell init
   ```
   Choose your AI backend (OpenAI or Gemini) and provide your API key.

2. **Start the interactive terminal**:
   ```bash
   star-shell run
   ```
   This opens an AI-powered terminal where you can chat and get commands executed.

3. **Or ask for specific commands**:
   ```bash
   star-shell ask "list all Python files in this directory"
   ```

## Commands

- `star-shell` - Shows status and quick help
- `star-shell init` - Set up your AI backend and API keys  
- `star-shell run` - Start the interactive AI terminal
- `star-shell ask "your request"` - Generate a specific command

## Backend Options

During initialization, you can choose from:
1. **OpenAI GPT-3.5 Turbo** - Reliable, requires API key
2. **Gemini Pro** - Google's flagship model, requires API key  
3. **Gemini Flash** - Faster Google model, requires API key
4. **Secret option** - For special access (contact developer)

## Supported AI Backends

- **OpenAI GPT-3.5 Turbo** - Requires OpenAI API key
- **Google Gemini Pro** - Requires Google AI API key
- **Google Gemini Flash** - Requires Google AI API key (faster, optimized model)
- **Secret Backend** - Free access for select users (no API key needed)

## Safety Features

Star Shell includes built-in safety checks for potentially dangerous commands:
- Warns about destructive operations (rm, format, etc.)
- Confirms before executing system-level changes
- Provides clear descriptions of what commands do

## Examples

### Interactive Terminal Mode
```bash
star-shell run

⭐ > create a new directory called projects
# AI will generate and offer to execute: mkdir projects

⭐ > create a directory and navigate to it
# AI will offer to execute multiple commands:
# 1. mkdir new_directory
# 2. cd new_directory

⭐ > what's the difference between git merge and rebase?
# AI will explain the concepts in natural language

⭐ > help
# Shows available commands and examples
```

### Direct Command Mode
```bash
# File operations
star-shell ask "create a backup of my config files"

# System information  
star-shell ask "show me disk usage"

# Development tasks
star-shell ask "start a Python web server on port 8000"
```

## Requirements

- Python 3.8+
- OpenAI API key OR Google AI API key

## License

MIT License - see LICENSE file for details.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.
