diff --git a/README.md b/README.md index 802e993..eb98698 100644 --- a/README.md +++ b/README.md @@ -1,115 +1,44 @@ # ShellGenius -AI-Powered Local Shell Script Assistant using Ollama. - -## Overview - -ShellGenius is a CLI tool that uses local LLMs (Ollama) to generate, explain, and refactor shell scripts interactively. Developers can describe what they want in natural language, and the tool generates safe, commented shell commands with explanations. +AI-Powered Local Shell Script Assistant using Ollama ## Features -- **Natural Language to Shell Generation**: Convert natural language descriptions into shell commands -- **Interactive TUI Interface**: Rich terminal UI with navigation, command history, and suggestions -- **Script Explanation Mode**: Parse and explain existing shell scripts line-by-line -- **Safe Refactoring Suggestions**: Analyze scripts and suggest safer alternatives -- **Command History Learning**: Learn from your command history for personalized suggestions -- **Multi-Shell Support**: Support for bash, zsh, and sh scripts +- Generate shell scripts using natural language +- Review and explain existing scripts +- Interactive REPL mode +- Local privacy - all processing done locally via Ollama +- Support for multiple shell types (bash, zsh, sh) ## Installation ```bash -# Install from source -pip install . - -# Install with dev dependencies -pip install -e ".[dev]" -``` - -## Requirements - -- Python 3.10+ -- Ollama running locally (https://ollama.ai) -- Recommended models: codellama, llama2, mistral - -## Configuration - -ShellGenius uses a `config.yaml` file for configuration. See `.env.example` for environment variables. - -```yaml -ollama: - host: "localhost:11434" - model: "codellama" - timeout: 120 - -safety: - level: "moderate" - warn_patterns: - - "rm -rf" - - "chmod 777" - - "sudo su" +pip install shellgenius ``` ## Usage -### Interactive Mode +### Generate a script ```bash -shellgenius +shellgenius generate "Create a backup script for /data directory" ``` -### Generate Shell Commands +### Review a script ```bash -shellgenius generate "find all Python files modified in the last 24 hours" +shellgenius review script.sh ``` -### Explain a Script +### Interactive REPL ```bash -shellgenius explain script.sh +shellgenius repl ``` -### Refactor with Safety Checks +## Configuration -```bash -shellgenius refactor script.sh --suggestions -``` - -## Commands - -| Command | Description | -|---------|-------------| -| `shellgenius` | Start interactive TUI | -| `shellgenius generate ` | Generate shell commands | -| `shellgenius explain