larpshell
Use terminal with natural language.
larpshell translates natural language into shell commands using AI, then executes them in your terminal (not without asking for confirmation of course). You can also edit the commands before running, or ask for an explanation of what they do. Both prompt templates for command generation and explanation are customizable.
Usage Demo
[!IMPORTANT] ALWAYS review the generated commands and know what they do before running them!
Requirements
Installation
From crates.io:
From source:
|
Packaged
From AUR (bin, latest release, no Rust needed):
yay -S larpshell
From AUR (git, latest commit):
yay -S larpshell-git
Setup
Configure your AI provider:
Pick a provider and enter credentials. Config is saved in ~/.config/larpshell/config.toml.
Supported providers
| Provider | About |
|---|---|
| Gemini | Free API key at aistudio.google.com/apikey |
| OpenRouter | Free models available with openrouter/auto (default, free models list) |
| Ollama | API key optional |
| OpenAI-compatible | any compatible API (custom base URL support) |
Usage
Single command
$ larpshell show disk usage
> df -h
Run this?
[Y/Enter] to execute, [E] to explain, [Arrow Up] to edit, [N] to cancel
Interactive mode
$ larpshell
larpshell> show disk usage
> df -h
Run this?
[Y/Enter] to execute, [E] to explain, [Arrow Up] to edit, [N] to cancel
Explain a command
$ larpshell explain df -h
> df -h
✅ Displays free disk space of mounted filesystems in a human readable format.
Run this?
[Y/Enter] to execute, [Arrow Up] to edit, [N] to cancel
Edit before running
Press Arrow Up at the confirmation prompt. Full cursor control with left/right, home/end, backspace/delete.
> df -h --total▉
[Enter] to confirm, [Ctrl+C] to quit
Subcommands
| Command | Description |
|---|---|
larpshell api |
Configure AI provider |
larpshell explain <cmd> |
Explain a command with safety rating |
larpshell prompt [system|explain] [show|edit] |
View or edit prompt templates |
larpshell uninstall |
Remove larpshell |
larpshell --help |
Show help |
How it works
- You describe what you want in plain language
- An AI provider translates your request into a shell command
- You review the command, edit it if needed, or ask for an explanation
- Press Enter to run it in your shell
Commands run via sh -c and preserve your working directory between invocations.
Review generated commands before running them. larpshell makes this easy with editing and explanation features, but you own what executes on your machine.