salvy9978

salvy9978 / pls

Public

Just say what you want. In your terminal.

pypi.orgprojectpls-sh ai cli command-line llm natural-language
44
5
100% credibility
Found Mar 24, 2026 at 44 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

pls is a terminal tool that turns natural language instructions into shell commands using AI models, complete with safety reviews before running.

How It Works

1
😎 Discover pls

You hear about pls, a handy helper that lets you boss your computer around using simple everyday words instead of confusing codes.

2
🔧 Get it ready

You add pls to your computer so it's there whenever you open your terminal.

3
🧠 Link a thinking brain

You pick a smart service—like a local one on your machine or an online whiz—to help pls understand your words.

4
🗣️ Say what you want

In your terminal, you type something natural like 'find all big files and sort them' and pls starts thinking.

5
🔍 See the plan

Pls shows you the exact computer instructions it came up with, highlights any risks, and explains if you ask.

6
👍 Give the thumbs up

You review and say yes to run it, feeling safe because pls warns about anything tricky.

🎉 Job done!

Your task finishes perfectly, and you get the results you wanted without typing a single complex command.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 44 to 44 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is pls?

pls lets you describe terminal tasks in plain English—like "find all files bigger than 100MB" or "compress all PNGs in this folder"—and generates the exact shell command using LLMs. It analyzes risks (safe, caution, dangerous), shows warnings for stuff like recursive deletes or sudo, and confirms before running, all from your CLI. Python-based, it defaults to local Ollama models but swaps easily to OpenAI or Anthropic APIs via simple config commands.

Why is it gaining traction?

Unlike basic shell translators, pls adds safety nets that block auto-running nukes like rm -rf, plus dry-run and explain modes for safe testing. Local-first with Ollama means no cloud dependency or "pls donate" API costs, and it pulls context like your OS, shell, and current files for smarter outputs. Devs dig the --last replay and stdin piping for quick iterations.

Who should use this?

Sysadmins whipping up ad-hoc commands without man-page dives. DevOps engineers prototyping Docker or git ops on the fly. Juniors bridging the shell learning curve, or anyone tired of syntax errors in high-stakes environments like production deploys.

Verdict

Grab it for pip install if Ollama's running—solid concept for AI-assisted terminals, especially local. 44 stars and 1.0% credibility scream alpha-stage rough edges (thin docs, no tests shipped), so test in sandboxes first.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.