HumanSH — Forgot the command? Stay in the terminal.
Stay in your terminal
Describe what you need. HumanSH writes the command directly into your terminal for review—no chatbot tab, no copy-paste, no lost flow.
Free and open source. Nothing runs until you approve it.
Your terminal in flow
Plain English in Reviewable command out
No tab switching
01
No new AI bill
Use what you already have
Connect a supported AI subscription you already pay for. A new paid API is not required.
02
No extra cloud service
One provider request
An ordinary translation talks only to your chosen AI provider. The HumanSH CLI sends no telemetry or analytics.
03
No broad machine access
Your machine stays yours
No files, shell history, environment variables, or credentials are sent in a translation request.
The interruption you know
The command is not the hard part. Leaving your work is.
You are already in the terminal when memory fails. The expensive part is the detour: open a chatbot, rebuild the context, wait, copy, switch back, paste.
Without HumanSH**2 apps · 6 steps**
Terminal stuck
% which flags did I need…
⌘ Tab
Chatbot new chat
Which command shows what is using port 3000?
lsof -nP -iTCP:3000…
1. Forget 2. Switch 3. Ask 4. Wait 5. Copy 6. Paste
With HumanSH**1 place · 3 steps**
Terminal in flow
% show which process is using port 3000
% lsof -nP -iTCP:3000 -sTCP:LISTEN
Review, then press Enter.
1. Describe 2. Review 3. Run
How it works
One request. Two Enters. You stay in control.
HumanSH keeps the important pause between generating a command and running it.
01
Describe
Type what you want to do
Use the words already in your head. There is no prompt template to learn.
% find the five largest files here
02
Review
The command appears in place
Nothing has run. Inspect it, edit it, or cancel it just like anything else in your prompt.
% find . -type f -exec du -h {} + | sort -rh | head -n 5
03
Run
Press Enter when it looks right
The reviewed command runs in the terminal you were already using.
Useful when needed. Invisible when not.
It knows when to stay quiet.
A local decision happens before any provider request.
Clear command**Runs normally**
`% git status` No added wait. No provider request.
Plain English**Translated for review**
`% undo the last commit but keep my changes` The command replaces your request—without running.
Genuinely ambiguous**Left untouched**
`% status report` HumanSH refuses to guess or send it.
Private by restraint
The shortest path needs the smallest footprint.
HumanSH is designed to do one job, ask for little, and leave control where it belongs—with you.
01
Nothing runs before you approve it
The generated command lands in your editable prompt. Read it, change it, cancel it, or press Enter to run it.
02
Risk gets a deliberate pause
Commands with destructive patterns require a stronger confirmation instead of an ordinary Enter.
03
Only a small request leaves
HumanSH sends your request and a small amount of system context—not your files, history, secrets, or command output.
04
The provider gets an empty workspace
Translations run in an isolated disposable directory with a minimal environment and tools disabled where supported.
05
No product tracking layer
The HumanSH CLI does not collect telemetry, create a cloud account, or add a separate analytics request.
06
No surprise paid fallback
OpenRouter's metered API is optional and explicit. HumanSH never silently switches you to it.
Read the complete security model
Current compatibility
Works with the AI you already use.
Provider names belong here, after the product is understood—not in the promise.
C
**ChatGPT subscription**
Use your existing ChatGPT login through Codex.
Existing login
A
**Claude subscription**
Use your existing claude.ai login.
Existing login
↗
**Cursor subscription**
Use your existing Cursor browser login.
Existing login
Optional
OpenRouter's metered API is available as an explicit fourth path. HumanSH never falls back to it silently.
Open source · MIT licensed
Stay in flow the next time memory fails.
Install HumanSH, follow the guided setup, and describe your first command in plain English.
Install HumanSH
`$ curl -fsSL https://humansh.com/install | bash` No sudo Checksum verified Guided setup
Questions, answered
The important details.
Does HumanSH run generated commands automatically? No. It inserts the command into your editable prompt for review. You decide whether to edit, cancel, or run it. Higher-risk commands require an additional deliberate confirmation.
What leaves my machine during a translation?
By default: your English request, the target command environment, operating-system and architecture details, a privacy-normalized folder label, and a fixed list of detected tools. Files, file contents, shell history, environment variables, credentials, usernames, and command output are not sent.
Do I need another paid AI API? No. HumanSH can use an existing supported ChatGPT, Claude, or Cursor subscription through its current login. OpenRouter's metered API is an optional path and is never selected silently.
Is HumanSH free? Yes. HumanSH is open source and costs nothing to install or use. Bring a supported subscription you already have, or explicitly choose OpenRouter's metered API.
What happens when I type a real command? HumanSH classifies clear commands locally and leaves them alone, so they run normally without a provider request. Genuinely ambiguous input is preserved rather than guessed or sent.