A split-terminal TUI that spots risky commands before execution, explains what you're typing, and helps you learn safer moves in a real shell. Friendly when you want help. Firm when it matters.
The only seatbelt that fits a terminal.
ridinCLIgun is a split-screen terminal interface. On the left: your actual shell — with colors, completion, history, everything you expect. On the right: an advisory pane that watches your input before you hit Enter and gives you useful context while the command is still harmless text.
That means more than just danger labels. Local pattern checks catch risky commands instantly. The built-in offline command catalog surfaces syntax and real examples as you type. Optional AI review goes deeper when you ask, and the history browser lets you revisit past reviews later. Secret Mode keeps every external call shut off when privacy matters.
Offline checks catch destructive patterns before execution. No network round-trip, no waiting.
Offline command knowledge adds syntax and concrete examples while you type, so the pane can help as well as warn.
Press Ctrl+G, R and let Claude, GPT, or Mistral explain what a command or script actually does. Only when you ask.
Open Ctrl+G, K to browse past reviews, recover useful suggestions, and learn from what already happened.
Full PTY with colors, completions, and history. Your shell, with a seatbelt — not a sandbox.
One toggle. Zero data leaves your machine. The AI features go silent, the local help and warnings stay sharp.
A piped install command can look routine. ridinCLIgun flags the risky pattern locally, explains why it matters, and immediately offers a review-first workflow instead of “just trust it.”
Open Ctrl+G, K and revisit past AI reviews, compare patterns, and recover useful suggestions without re-running the whole analysis. Helpful for repeated tasks, onboarding, and learning by accumulation.
Start typing tar and the advisory pane can show syntax and concrete examples from the local command catalog. So the tool does not just say “careful” — it helps you get the command right.
Protects you and your loved ones from rm -rf. Also from dd, mkfs, and that clipboard you forgot about.
The terminal is exciting — until it bites. ridinCLIgun explains what a command does before you run it, turning every mistake into a lesson instead of a recovery job.
"Did I just break something?"You know enough to be dangerous: rm -rf, chmod 777, accidental sudo on the wrong directory. ridinCLIgun catches the classics before they become war stories.
Installation scripts via curl | bash, disk-level tools like dd and mkfs, deployment pipelines that touch production. ridinCLIgun reviews scripts and flags risky patterns before execution.
Obfuscated payloads, clipboard injection attacks, supply-chain risks in piped scripts. ridinCLIgun adds a second pair of eyes where it matters — between intent and execution.
"Does this command match the intent?"One wrong DROP TABLE or a deployment to the wrong environment, and it's an incident. ridinCLIgun catches dangerous database operations and ambiguous targets before the query runs.
Teaching the command line means watching students type dangerous things. ridinCLIgun turns the terminal into a safer learning environment — with warnings that explain, not just block.
"Please don't run that in the shared environment."The terminal is powerful. It's also unforgiving. One misplaced flag and you're restoring from backup — or explaining to your team why main looks different now.
ridinCLIgun was built to make the command line less intimidating for the curious. Warnings teach you what a command does, not just that it's dangerous.
The local warning engine runs before execution — no round-trip, no delay. The dangerous command never leaves your input line.
This is not an auto-corrector. It does not modify, block, or rewrite your commands. It informs. You decide. Guardrails, not handcuffs.
Somewhere, someone just ran rm -rf / without thinking. Somewhere else, someone got warned first. Be the second person.
Where ridinCLIgun is heading. Vision, not promises — this is a personal project with no fixed timeline.
Settings UI, toast notifications, clipboard safety, onboarding flow, AI review with redaction preview, deep script analysis, API key management, CI pipeline, and security hardening.
Offline command knowledge with a 6,600+ command catalog, typo detection, German and French locale overlays, smarter AI prompts, AI replies in your language, Explorer mode, review history, full UI localisation, and persistent provider/model settings.
Streaming AI responses, conversational follow-up after a review, approval tiers, per-command context, session memory, scrollbar indicators, and token-cost awareness.
A learning game with real terminal challenges, Linux support, Homebrew/pipx distribution, custom risk catalogs, and OS-aware advisory.
Agent cockpit for proposed commands, multi-agent integration, a full local audit log, and reusable workflow templates — with the human always in control.
No. ridinCLIgun is a helper, not an autopilot. It can watch, warn, explain, and cover your back before execution, but your shell stays yours and you are always the one who decides whether to press Enter.
By default, no. Local warnings and offline command help stay on your machine. AI review only sends data to your chosen provider when you explicitly ask for it with Ctrl+G, R, and Secret Mode shuts external communication off completely.
ridinCLIgun works with any shell that runs in a PTY — bash, zsh, fish, and others. It wraps your default shell rather than replacing it, so your config, aliases, completions, and normal habits still work.
Right now it is macOS-only (tested on macOS 13+). Linux support is planned, and Windows is on the longer path after that. The intent is to keep the same helper-first experience across platforms, not build a separate stripped-down version.
Yes. ridinCLIgun is free and open source under GPL-3.0-or-later. No paid tier, no premium lock-in, no usage limits. If you want AI review, you bring your own API key and keep control over which provider is used.
Clone the repository and follow the README. It requires Python 3.12+ and runs as a standalone terminal application. The goal is to get you into a real working shell quickly, with the helper layer ready from the start.
Not yet — custom rules are planned for a future version. Today the built-in rule set covers a wide range of risky patterns out of the box, and later versions are meant to let teams and instructors tailor the helper to their own environment.
Local warnings are instant, offline, and pattern-based — they catch known risky commands quickly. Offline command help adds examples and syntax while you type. AI review is the deeper layer you can call in when you want explanation, script analysis, or a second opinion. Together they make the tool feel less like a siren and more like a capable copilot.
ridinCLIgun is open source, early-stage, and built in the open.
Explore the code, try it out, or just read the README — it's a good one.
