Metadata-Version: 2.4
Name: shix
Version: 0.1.16
Summary: Find and run shell commands using natural language, powered by your shell history
Project-URL: Homepage, https://github.com/m3o0/shix
Project-URL: Repository, https://github.com/m3o0/shix
Project-URL: Issues, https://github.com/m3o0/shix/issues
Author-email: Nicolaj Larsen <nicolajlarsen@hotmail.dk>
License-Expression: MIT
Keywords: cli,command,history,search,shell,terminal,tui
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Shells
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: rich>=13.0.0
Requires-Dist: textual>=0.50.0
Requires-Dist: typer>=0.9.0
Description-Content-Type: text/markdown

# shix

Find and run shell commands using natural language — powered by your own shell history.

shix searches your shell history to suggest relevant commands based on what you describe. No cloud, no API keys, just your local history.

## Install

```bash
pip install shix
```

## Usage

```bash
# Describe what you want to do
shix ask "docker compose restart"
shix ask "git push"
shix ask "activate virtual environment"

# Show more results
shix ask "git" --top 15
```

An interactive TUI opens where you can:

- **Arrow keys** to navigate between suggestions
- **Enter** or **click** to copy a command to clipboard
- **Mouse hover** to highlight a suggestion
- **Scroll** through many results
- **Esc** or **q** to quit

## Options

| Flag | Short | Description |
|------|-------|-------------|
| `--top N` | `-t` | Number of suggestions (default: 10) |
| `--history N` | `-n` | Limit history lines (0 = all, default: 0) |
| `--version` | `-v` | Show version |

## How it works

1. Reads your shell history (`~/.zsh_history`, `~/.bash_history`, or PowerShell history on Windows)
2. Matches your query against history using fuzzy search
3. Displays results in an interactive TUI for quick selection

## Supported shells

- **zsh** (macOS/Linux)
- **bash** (macOS/Linux)
- **PowerShell** (Windows)

## License

MIT
