SHELLY

An AI assistant for your terminal that does exactly what it's meant to do: provide intelligence for command output and natural language questions.

Quick Start

# Pipe command output
echo "test" | shelly "explain this"

# Pipe with errors
find / -name "*.log" 2>&1 | shelly "find log files and explain errors"

# Direct question
echo "test" | shelly "explain"

# Ask anything
shelly "how to backup directory"

Features

• Multi-provider AI integration (Anthropic, OpenAI, Google Gemini)
• Interactive config setup on first run
• Terminal-aware responses

Installation

From Pre-built Binaries

Download from GitHub Releases:

# Linux (x86_64)
wget https://github.com/vinaykulk621/shelly/releases/latest/download/shelly_Linux_x86_64.tar.gz
tar -xzf shelly_Linux_x86_64.tar.gz
sudo mv shelly /usr/local/bin/

# Linux (i386 - 32-bit)
wget https://github.com/vinaykulk621/shelly/releases/latest/download/shelly_Linux_i386.tar.gz
tar -xzf shelly_Linux_i386.tar.gz
sudo mv shelly /usr/local/bin/

From Source

# Install Go 1.25+
# Clone and build
git clone https://github.com/vinaykulk621/shelly.git
cd shelly
go build -o shelly

# Install to GOPATH
sudo mv shelly /usr/local/bin/

Configuration

Shelly creates config at $HOME/.shelly/shelly.toml on first run. Edit it to add your API keys:

[anthropic]
api_key = "your-key"
model = "claude-3-7-sonnet-20250219"

[openai]
api_key = "your-key"
model = "gpt-5.2"

[gemini]
api_key = "your-key"
model = "gemini-3.5-flash"

[default]
provider = "anthropic"  # Set your preferred default provider

Usage

# Basic command explanation
ls -la | shelly "explain"

# Error analysis with stderr
find / -name "*.log" 2>&1 | shelly "find log files and explain any errors"

# Direct question without piped input
shelly "how to backup directory"

# Multi-command pipeline
cat file.txt | grep "error" | shelly "analyze these errors"