Metadata-Version: 2.4
Name: naturally-linux
Version: 0.1.2
Summary: Natural-language to Linux shell command AI CLI tool with safety checks
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: groq>=1.0.0
Requires-Dist: mkdocs>=1.6.1
Requires-Dist: mkdocs-material>=9.5.49
Requires-Dist: pytest>=9.0.2
Requires-Dist: python-dotenv>=1.2.1
Requires-Dist: typer>=0.21.1

# Naturally Linux

Naturally Linux is a command-line tool that turns natural-language requests into safe, reviewable Linux shell commands. It shows you the proposed command, explains what it does, and runs it only after confirmation.

## Features

- Natural-language → shell command generation
- Command preview and explanation
- Safety checks before execution
- Confirmation before running commands

## Install

```
pip install naturally-linux
```

## Setup

Set your Groq API key:

```
export GROQ_API_KEY="your-key"
```

## Usage

Generate and run a command:

```
naturally-linux run "list files larger than 10MB"
```

Preview with explanation only:

```
naturally-linux run "list files larger than 10MB" --dry-run
```

## License

MIT
