Skip to main content

AI-powered CLI tool that connects natural language with developer workflows

Project description

 ██████╗ ███████╗ ██████╗██████╗ ██╗   ██╗██████╗ ████████╗
 ██╔══██╗██╔════╝██╔════╝██╔══██╗╚██╗ ██╔╝██╔══██╗╚══██╔══╝
 ██║  ██║█████╗  ██║     ██████╔╝ ╚████╔╝ ██████╔╝   ██║   
 ██║  ██║██╔══╝  ██║     ██╔══██╗  ╚██╔╝  ██╔═══╝    ██║   
 ██████╔╝███████╗╚██████╗██║  ██║   ██║   ██║        ██║   
 ╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝   ╚═╝   ╚═╝        ╚═╝   

AI-powered CLI tool that connects natural language with developer workflows:

  • Git commit generation (with optional auto-commit and auto-push)
  • Shell command generation (PowerShell & Linux Bash support)
  • Slang / abbreviation decoding

Powered by Google Gemini API.


New in v1.1.4

  • Self-Healing - Failed commands are automatically corrected by AI
  • Dry-Run Mode - Test commands safely with --dry-run
  • Dangerous Command Blocking - Protection against rm -rf, fork bombs, etc.
  • 30s Timeout - Commands can't hang indefinitely

Features

1. Commit Generator (default mode)

Generates Conventional Commit messages from:

  • staged git diff (git diff --staged)
  • or manual input text

Prompts to run git commit and git push.

# From staged diff
git add .
decrypt

# From description
decrypt "fix auth bug in jwt middleware"

# Auto-execute (skip prompts)
decrypt --auto

2. Shell Command Generator

Convert natural language into executable terminal commands. Supports both PowerShell and Bash.

# Windows PowerShell (default shell mode)
decrypt -s "find all png files larger than 10MB and delete them"

# Linux / macOS Bash
decrypt -b "kill all processes on port 3000"

3. Slang Decoder

Expands internet slang, abbreviations, and vowel-less text into readable text.

decrypt -sl "hru btw idk"

4. Interactive Mode

Run without input arguments to start a loop:

decrypt

Dry-Run Mode (--dry-run)

Only generates output, never executes anything.

decrypt --dry-run -s "delete all node_modules folders"
decrypt --dry-run -c "add caching layer for api"

Installation

From PyPI

pip install decrypt

Using pipx

pipx install decrypt

Local development install

git clone [https://github.com/REvDl/Scripts.git](https://github.com/REvDl/Scripts.git)
cd Scripts/automation_tool/DecrypMessage
pip install .

Configuration

On first run, the tool configures automatically:

  • Gemini API key
  • Default language

Stored at:

~/.config/decrypt/.env

Reset configuration:

decrypt --config

CLI Usage

usage: decrypt.exe [-h] [--lang LANG] [--config] [-sl] [-s] [-b] [-c] [-dr] [-a] [text]

AI-powered CLI tool
• Conventional Commits
• Shell Commands
• Slang Decoder

positional arguments:
  text            Optional text input. Commit mode (default): if empty, uses git diff; if provided, generates commit from this description.

options:
  -h, --help      show this help message and exit
  --lang LANG     Transcription language (default from .env)
  --config        Force re-configure API key and language
  -sl, --slang    Mode: Accurately expand and decipher internet abbreviations and slang
  -s, --shell     Mode: Generate an executable shell command from natural language
  -b, --bash      Mode: Generate an executable Linux Bash command from natural language
  -c, --commit    Mode: Generate Git commit message from text or staged diffs (default)
  -dr, --dry-run  Mode: generating commands without executing them
  -a, --auto      Auto-execute mode (skips confirmation prompts)

Tech Stack

  • Python 3.10+
  • Google Gemini API (google-genai)
  • Tenacity (with model fallback handling)
  • Pydantic Settings
  • argparse

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

decrypt-1.1.4.tar.gz (8.5 kB view details)

Uploaded Source

Built Distribution

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

decrypt-1.1.4-py3-none-any.whl (9.1 kB view details)

Uploaded Python 3

File details

Details for the file decrypt-1.1.4.tar.gz.

File metadata

  • Download URL: decrypt-1.1.4.tar.gz
  • Upload date:
  • Size: 8.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.4

File hashes

Hashes for decrypt-1.1.4.tar.gz
Algorithm Hash digest
SHA256 a9de4297e216418cca22f9a7ef7a76629d6d78af40ee492325902e337b0a478e
MD5 b726832e169c3c46992d4b36f299218f
BLAKE2b-256 75b14dd1650b4739c34c9d28bcaa8ad2890408fb7f73a556deda7fea7b0f28e4

See more details on using hashes here.

File details

Details for the file decrypt-1.1.4-py3-none-any.whl.

File metadata

  • Download URL: decrypt-1.1.4-py3-none-any.whl
  • Upload date:
  • Size: 9.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.4

File hashes

Hashes for decrypt-1.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a91aeb25faa57cf531f97dbfe61efb75d5f1c69af8d711a4460e0a72be652757
MD5 146977245618d161e606fe3fcc09a02d
BLAKE2b-256 7628c0b7e186280cb915f8c9d827579804339f18c4fbfaf6d46e5b9228e90316

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