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.5

  • Streaming Output - AI responses now print in real-time as they generate
  • Commit Diff Preview - Shows git diff --stat --cached before confirming commit

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.6.tar.gz (21.3 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.6-py3-none-any.whl (22.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: decrypt-1.1.6.tar.gz
  • Upload date:
  • Size: 21.3 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.6.tar.gz
Algorithm Hash digest
SHA256 b33ed4759369ee840896d7efad5c01784984cf0474d1008919b6988577942774
MD5 7180d991d342ee102d5719de9ae5aa3e
BLAKE2b-256 12920cb928fdbff812d7551f40eaac170872c55c5aead8dd4495b36bba92ebdf

See more details on using hashes here.

File details

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

File metadata

  • Download URL: decrypt-1.1.6-py3-none-any.whl
  • Upload date:
  • Size: 22.0 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 70b3cf12485e20d231d65722a7cfed0cedb06be30d18f230aa68316c1346dee0
MD5 cdf2b0ee6c932005cbebf4aa9249fddf
BLAKE2b-256 d8c41106c096d093d48697151339b8b5369bb5fb77874373d811f0f5d5821796

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