# ricklamers/shell-ai

LangChain powered shell command generator and runner CLI

Repository: https://github.com/ricklamers/shell-ai
Canonical: https://ross.abutalabs.com/products/shell-ai
Language: Python
License: MIT
License Family: permissive
Topics: langchain, llm, openai, gpt, automation, cli, shell
Last push: 2025-09-17T15:56:53+00:00

## Health v2 (maintenance only)
Score: 47/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 42, release rhythm 35, longevity 79
- inputs: {"age_days": 1109, "days_push": 350, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1154, forks 80 (observed 2026-08-28T04:03:47.516226+00:00)

## What it is
Shell-AI (shai) is a Python CLI utility that converts natural language descriptions into shell command suggestions using LLMs via LangChain. It presents interactive command suggestions and can run them after confirmation, supporting OpenAI, Azure, Groq, and Ollama providers.

## Use cases
- generate shell commands from natural language
- find the right terraform command without reading docs
- ai assistant for the terminal
- convert plain english to bash commands
- get command suggestions in the cli
- avoid memorizing complex shell flags

## When to choose
- you want a lightweight terminal tool that turns intent into shell commands
- you want provider flexibility across OpenAI, Azure, Groq, and local Ollama
- you prefer interactive confirmation before running suggested commands

## When to avoid
- you need multi-step agentic task execution rather than single-line commands
- you cannot send prompts to an external LLM provider due to privacy constraints
- you need a full shell replacement or persistent AI session

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, llm-inference, agent-framework, developer-tools, workflow-automation
- domain: developer-tools, large-language-models
- platform: cli, python, windows, cross-platform
- tags: shell-commands, natural-language-to-command, langchain, openai, ollama, groq, terminal-assistant, command-line, automation, linux, macos

## Member repositories
- ricklamers/shell-ai (main) score 47

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:47.516226+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:33:23.493166+00:00, confidence not recorded.
  - readme: https://github.com/ricklamers/shell-ai (fetched 2026-08-28T04:03:47.516226+00:00, sha b3727b28bf2c)
- Data as of 2026-08-30T08:39:29.467469+00:00.