Metadata-Version: 2.4
Name: star-shell
Version: 0.1.2
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 Chat Mode**: Have conversations with your shell assistant
- 🛡️ **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

## Installation

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

## Quick Start

1. **Initialize Star Shell**:
   ```bash
   star-shell init
   ```
   Choose your AI backend (OpenAI or Gemini) and provide your API key.

2. **Ask for commands**:
   ```bash
   star-shell ask "list all Python files in this directory"
   ```

3. **Start interactive chat**:
   ```bash
   star-shell chat
   ```

## Commands

- `star-shell init` - Set up your AI backend and API keys
- `star-shell ask "your request"` - Generate a command for your request
- `star-shell chat` - Start an interactive chat session

## Supported AI Backends

- **OpenAI GPT-3.5 Turbo** - Requires OpenAI API key
- **Google Gemini Pro** - Requires Google AI API key

## 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

```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"

# Git operations
star-shell ask "commit all changes with message 'update docs'"
```

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