Claude-powered terminal assistant — ask CLI questions and run commands safely
Project description
Shell AI
Claude-powered terminal assistant that answers CLI questions and runs commands safely on Linux, macOS, and Windows.
Install
pipx install shellai-cli
Requires Python 3.8+. Install pipx with
brew install pipx(macOS) orpip install pipx.
Setup
Create ~/.shellai/.env with your Anthropic API key:
mkdir -p ~/.shellai
echo "ANTHROPIC_API_KEY=sk-ant-YOUR-KEY-HERE" > ~/.shellai/.env
Get a key at console.anthropic.com.
Run
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
pipx upgrade shellai
Uninstall
pipx uninstall shellai
Release history Release notifications | RSS feed
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 shellai_cli-0.1.0.tar.gz.
File metadata
- Download URL: shellai_cli-0.1.0.tar.gz
- Upload date:
- Size: 8.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a3b82e3c21871465bdc9c1f257ceffc8bf87ca4ece4027ea1618001baee88e31
|
|
| MD5 |
4592ca84d6b84c34edf18d2d98612c5f
|
|
| BLAKE2b-256 |
c3231f7aff5c090689c5896dd3ae58a676a188db9daf0d121e03b33af95c096b
|
File details
Details for the file shellai_cli-0.1.0-py3-none-any.whl.
File metadata
- Download URL: shellai_cli-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
880b7c45f6ac105c946339910fbb3ff900afe1169d5da845a65dff635f5cb8ea
|
|
| MD5 |
6dbc23712b9e542bad37d8134d24efd0
|
|
| BLAKE2b-256 |
e7f970a5c49985a1b8e2cdf9989821d7d44fd72ad75dc0427400772e07f14533
|
