An AI-powered CLI agent that lives in your terminal. Ask it questions or have it run shell commands on your behalf.
- Python 3.13+
- An Anthropic API key
# macOS / Linux
git clone https://github.com/Ahmedmk11/shell-ai.git
cd shell-ai
python -m venv .venv
source .venv/bin/activate
pip install -e .
# Windows (PowerShell)
git clone https://github.com/Ahmedmk11/shell-ai.git
cd shell-ai
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e .Export your credentials before running:
export ANTHROPIC_API_KEY=your_api_key_here
export ANTHROPIC_MODEL=claude-opus-4-5To avoid doing this every session, add them to your ~/.bashrc or ~/.zshrc.
or create a .env file in the project root with the following content:
ANTHROPIC_API_KEY=your_api_key_here
ANTHROPIC_MODEL=claude-opus-4-5
shellaishellai --no-exec --no-usage| Flag | Description |
|---|---|
--temperature |
Model temperature (default: 0) |
--no-exec |
Disable command execution |
--no-path |
Show only current folder name instead of full path |
--no-usage |
Hide token usage stats |
(ShellAI) bash ~/projects/shell-ai> how many python files are in this project?
(ShellAI) bash ~/projects/shell-ai> run git status
(ShellAI) bash ~/projects/shell-ai> clear
(ShellAI) bash ~/projects/shell-ai> exit
Type naturally to talk to the AI, or prefix with run to execute shell commands directly, bypassing the AI entirely. The agent will always show you the exact command it ran and its output.