Metadata-Version: 2.4
Name: shellai-cli
Version: 0.1.0
Summary: Claude-powered terminal assistant — ask CLI questions and run commands safely
Author-email: Gerco Hissink <ghissink@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/ghissink/shellai
Project-URL: Source, https://github.com/ghissink/shellai
Keywords: cli,shell,ai,claude,terminal,assistant
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
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
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: anthropic>=0.25.0
Requires-Dist: rich>=13.0.0
Requires-Dist: python-dotenv>=1.0.0
Dynamic: license-file

# Shell AI

Claude-powered terminal assistant that answers CLI questions and runs commands safely on Linux, macOS, and Windows.

## Install

```bash
pipx install shellai-cli
```

> Requires Python 3.8+. Install pipx with `brew install pipx` (macOS) or `pip install pipx`.

## Setup

Create `~/.shellai/.env` with your Anthropic API key:

```bash
mkdir -p ~/.shellai
echo "ANTHROPIC_API_KEY=sk-ant-YOUR-KEY-HERE" > ~/.shellai/.env
```

Get a key at [console.anthropic.com](https://console.anthropic.com).

## Run

```bash
shellai
```

## Usage

| Action | What to type |
|--------|-------------|
| Ask a question | Just type it and press Enter |
| Reset conversation | `clear` |
| Show help | `help` |
| Quit | `exit` or Ctrl+C |

When Shell AI suggests a command it shows it in a panel. Read-only commands (like `ls`, `cat`) run automatically. All other commands ask **"Run this command? [y/N]"** before executing. Destructive commands are highlighted with a red warning.

## Update

```bash
pipx upgrade shellai
```

## Uninstall

```bash
pipx uninstall shellai
```
