Natural-language to Linux shell command AI CLI tool with safety checks
Project description
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 (recommended)
Install the UV package manager, then install the CLI system-wide:
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install naturally-linux
Alternative (pip):
pip install naturally-linux
Setup
Store your Groq API key (recommended):
naturally-linux config set-key YOUR_GROQ_API_KEY
Or set it via environment variable:
export GROQ_API_KEY="your-key"
Usage
Generate and run a command:
naturally-linux "list files larger than 10MB"
Preview with explanation only:
naturally-linux "list files larger than 10MB" --dry-run
Set a timeout (seconds):
naturally-linux "scan logs" --timeout 10
Manage API key:
naturally-linux config show
naturally-linux config delete
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file naturally_linux-0.1.4.tar.gz.
File metadata
- Download URL: naturally_linux-0.1.4.tar.gz
- Upload date:
- Size: 8.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dacee08332b217197c99b74b052aab19ebd5269070210cb47cc005f6dbed7867
|
|
| MD5 |
906823a4087c69b57ee1a0a30763b06b
|
|
| BLAKE2b-256 |
980e5771da3330dc9bd42449775e8f9034a39e60d94044dc8aa81eaa8870ec7c
|
File details
Details for the file naturally_linux-0.1.4-py3-none-any.whl.
File metadata
- Download URL: naturally_linux-0.1.4-py3-none-any.whl
- Upload date:
- Size: 9.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
989e1bc4bad60bee954caa6c06fbd023d17faf6164be3ff5ff19dba293b5359a
|
|
| MD5 |
3c94880873c018ebb3d6e6b55ca9238f
|
|
| BLAKE2b-256 |
bf987bb37e711713f3f39e098e5bd42c299b9e3ea665c0fb8ccf550199b386fc
|
