Agentic Shell (AGIsh) is an experimental shell where commands are interpreted and run by a large language model (LLM). AGIsh can be used to test and evaluate LLMs on a variety of tasks as well as used as your natural language shell.

• Command completion & directory autocomplete
• History (persistent across sessions)
• Use your own API keys
• Agentic loop to fix commands
• Pipe commands into shell to run
• Mac OS & Linux shell support
• Run against multiple LLM providers (in progress)
• Windows & Powershell support (in progress)
• Support for plugins to extend agish functionality
• Run with local LLM models
• Support for .agishrc file to set default LLM provider, API keys, etc.
• MCP Server support

• Interactive commands (vim, nano, top, read, etc.) - these are not supported because they require stdin input and are not supported by the current version of agish. Adding proper support for these will require recreating an entire terminal emulator (or using node-pty with custom shell interceptors for every shell) in agish which is not a goal of this project.

Download from releases, chmod +x and move to a directory in your PATH or follow one of the guides below.

curl -L https://github.com/Flux159/agentic-shell/releases/download/v1/agish-macos-arm64 -o agish
chmod +x agish
sudo mv agish /usr/local/bin/ # Or move to any other directory in your PATH

curl -L https://github.com/Flux159/agentic-shell/releases/download/v1/agish-macos-x64 -o agish
chmod +x agish
sudo mv agish /usr/local/bin/ # Or move to any other directory in your PATH

curl -L https://github.com/Flux159/agentic-shell/releases/download/v1/agish-linux-x64 -o agish
chmod +x agish
sudo mv agish /usr/local/bin/ # Or move to any other directory in your PATH

In your shell, make sure you have the following environment variable is set.

Get an Anthropic API Key from https://console.anthropic.com/settings/keys (see this guide for more: https://docs.anthropic.com/en/api/getting-started).

export ANTHROPIC_API_KEY="abcd"

• ANTHROPIC_API_KEY - Required. Your Anthropic API key
• DEBUG - Optional. Set to any value to enable debug logging

$ agish
> list files in the current directory

Special commands:

• /help - Show help text
• /history - Show command history
• /exit or /quit - Exit the shell
• Up / Down arrows to navigate command history (will load history from previous sessions as well)

Piping commands to agish:

echo "list files in the current directory" | agish

Piping with heredoc:

cat << EOF | agish
list files in the current directory
zip the files in this directory into dist.zip
EOF

Build up a directory of test suites for LLMs in a directory & run all of them against agish:

find tests/ -type f -exec agish < {} \;

git clone https://github.com/Flux159/agentic-shell.git
cd agentic-shell
npm install
cp .env.local.example .env.local
# Update .env.local with your API keys
npm run dev

npm run build

MIT License