😤 The Problem

Every terminal user knows this pain:

$ docker run -it --rm -v /home/user/projects:/workspace -p 8080:8080 myimage:latest
                                         ^^^^^^^^
                                    typo is here 😭

Your options?

There is no way to just click where you want to edit. Until now.

✅ The Solution

termjump opens a lightweight inline editor right in your terminal.
Press Ctrl+E → the editor pops up → click any character → cursor jumps there → fix it → Enter.

┌──────────────────────────────────────────────────────────────────────┐
│  ● termjump — smart command editor                                   │
│                                                                      │
│  docker run -it --rm -v /home/user/projects:/workspace -p 8080:8080  │
│                                    ^                                 │
│                               click here                             │
│                                                                      │
│  termjump  col 36/72    ENTER confirm · ESC cancel · click to jump   │
└──────────────────────────────────────────────────────────────────────┘

🚀 Quick Start

1. Install

pip install termjump

2. Add to your ~/.zshrc

eval "$(termjump init)"

3. Reload your shell

source ~/.zshrc

4. Use it

Type any command → press Ctrl+E → click any character → edit → Enter

🎮 How It Works

 You type a command          Press Ctrl+E            Click a character
 ─────────────────           ────────────            ─────────────────

 $ git commit -m            ┌────────────┐           ┌────────────────┐
   "fix autentication"  ──► │  termjump  │  ──────►  │ cursor jumps   │
                            │  editor    │   click!   │ exactly there  │
                            └────────────┘           └────────────────┘
                                                             │
                                                             ▼
                                                      Fix typo → Enter
                                                      Command runs ✓

⌨️ Keyboard Shortcuts

⚙️ Configuration

Change the trigger key (default is Ctrl+E):

# In your ~/.zshrc, after the eval line:
eval "$(termjump init)"
bindkey '^F' _termjump_widget   # Ctrl+F instead

📋 Requirements

• Python 3.10+
• Shell — zsh (default on macOS since Catalina)
• Terminal with mouse support:
  • ✅ iTerm2
  • ✅ Kitty
  • ✅ WezTerm
  • ✅ macOS Terminal.app

🤝 Contributing

PRs and issues are very welcome!

git clone https://github.com/srisowmya2000/termjump
cd termjump
pip install -e ".[dev]"
python tests/test_termjump.py