explaingit

suhjae/koter

Analysis updated 2026-05-18

15ShellAudience · developerComplexity · 2/5Setup · easy

TLDR

A joke shell extension that forces you to type Linux commands entirely in Korean, rejecting any English input.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Try out the Korean-only command translations temporarily in a single terminal session.

USE CASE 2

Install it permanently to force yourself or others to type shell commands in Korean.

USE CASE 3

Add new command translations or synonyms to the dictionary and rebuild the script.

USE CASE 4

Switch back to English temporarily or uninstall it completely with a single command.

What is it built with?

ShellBashZsh

How does it compare?

suhjae/koteraduskelebe/diffpilotamrit-regmi/immich_edge
Stars151515
LanguageShellShellShell
Setup difficultyeasyeasyhard
Complexity2/52/54/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

No dependencies beyond bash 4+ or zsh, a one-line curl script installs it, or source it directly for a temporary trial.

In plain English

Koter is a playful bash and zsh shell extension that forces you to type Linux commands, their subcommands, and their options entirely in Korean instead of English. If you type an English command like ls, it refuses to run it and shows a message telling you to use the Korean word instead. It currently ships 391 Korean translations, and the project deliberately avoids simple sound-alike transliterations, aiming instead for genuine, sometimes humorous Korean equivalents of terms like git, vim, sudo, or ssh. The checking is thorough: it is not just the main command that must be in Korean, but also subcommands and flags in their correct positions, so you cannot bypass it by translating only part of a command. For example, running sudo apt install with any part left in English gets rejected step by step until every piece is in Korean. You can try it instantly in your current terminal session without installing anything, by sourcing a script directly from a URL, and it disappears without a trace once you close the tab. For permanent use there is a one-line install script that downloads a file into a hidden folder in your home directory and adds a single source line to your shell's startup file, without creating any separate configuration file. Commands exist to temporarily switch back to English, switch back to Korean, or fully uninstall it. The project is careful not to break your shell as a joke: it only intercepts commands you type directly, letting anything running inside pipes, your prompt, autocomplete, or sourced scripts pass through untouched, and it preserves any existing shell functions you had defined so switching back to English restores them exactly. Real filenames are also never translated. The dictionary and build scripts are included so contributors can add new commands, subcommands, options, and synonyms, with the build step rejecting duplicate Korean words automatically. It requires bash 4 or newer, or zsh, and has no other dependencies.

Copy-paste prompts

Prompt 1
I want to try koter without installing it, how do I load it into just my current terminal session?
Prompt 2
Explain how koter checks subcommands and options, not just the main command, to prevent typing English.
Prompt 3
I want to add a new command translation to koter, walk me through editing the dictionary file and rebuilding it.
Prompt 4
How does koter make sure it doesn't break scripts, cron jobs, or piped commands while still blocking interactive English input?

Frequently asked questions

What is koter?

A joke shell extension that forces you to type Linux commands entirely in Korean, rejecting any English input.

What language is koter written in?

Mainly Shell. The stack also includes Shell, Bash, Zsh.

How hard is koter to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is koter for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.