Skip to main content

Natural langauge shell commands.

Project description

shllm

Generate shell commands using natural langauge.

Installation

echo "export SHLLM_OPENAI_KEY={{OpenAI API Key}}" >> ~/.zshrc
pip install uv
uv pip install shllm

Alternatively:

echo "export SHLLM_OPENAI_KEY={{OpenAI API Key}}" >> ~/.zshrc
pipx install shllm

Usage

shllm {{what you want to do}}

Example

shllm show how many gigabytes of free space I have left on my hard drive
Command to be copied to clipboard: df -h . | awk 'NR==2 {print $4}'
What would you like to do? [c]opy to clipboard, [r]un the command, [q]uit: c
Command has been copied to the clipboard.

Features

  • Cross-platform clipboard support: Works in various environments including SSH sessions
  • Multiple clipboard backends: Automatically tries different clipboard mechanisms based on your environment:
    • Desktop environments: pyperclip
    • macOS: pbcopy
    • Linux X11: xclip, xsel
    • Linux Wayland: wl-copy
    • Android (Termux): termux-clipboard-set
    • Windows: clip
  • Run directly: Execute commands directly without copying
  • Non-interactive mode: Automatically detects non-interactive environments (like CI pipelines) and skips prompts

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shllm-0.0.6.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

shllm-0.0.6-py3-none-any.whl (3.6 kB view details)

Uploaded Python 3

File details

Details for the file shllm-0.0.6.tar.gz.

File metadata

  • Download URL: shllm-0.0.6.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for shllm-0.0.6.tar.gz
Algorithm Hash digest
SHA256 78f05031c1990f39f8a77d6d440bc9c3510ab3e5c1091d77b38f964d6cde25da
MD5 cf8cf3612059572ad6d01e2a4910b4af
BLAKE2b-256 ed0563f6bfbb10fdf2f20b6f9b5ef5a31560b8ff885cb3078d868e2c171aa283

See more details on using hashes here.

File details

Details for the file shllm-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: shllm-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 3.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for shllm-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 e3518674c75a3a7ac3990fdeb249a82269f9f0e4393230cfe032dacc173f041b
MD5 a5f153d1243a11d5998155161648e2e7
BLAKE2b-256 5ac7e7e7f3d2b7fbfafd3403af90b7dcbbbfc7e14cf8e00e1295de02d775a4a7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page