ccline — zsh shell integration using the claude CLI, type thoughts at your prompt and run the answer

[jianshuo]

I built ccline — a zsh shell companion that brings the claude CLI to your everyday terminal workflow.

The concept: Instead of switching to a Claude window to ask a shell question, you type it directly at your zsh prompt.

ccline hijacks command_not_found_handler. When you type something that is not a real command:

• One word → treated as a normal typo
• Two or more words → sent to Claude (or Codex as fallback), answer rendered as Markdown

Any shell commands in the answer appear in an arrow-key selection menu — hit Enter and they execute in your live shell (so cd, export, and shell history all persist).

$ how do I find files bigger than 100MB here

    find . -maxdepth 1 -type f -size +100M

Commands found — ↑/↓ to choose, Enter to run, q to cancel:
 ❯ find . -maxdepth 1 -type f -size +100M
   find . -type f -size +100M
   ➤ Run all of them
   ✗ Cancel
$ find . -maxdepth 1 -type f -size +100M
./big.iso

Install (one line):

curl -fsSL https://raw.githubusercontent.com/jianshuo/ccline/v0.2.2/install.sh | bash

Requires zsh + the claude CLI (which you already have if you use Claude Code). No other dependencies — not even glow (though it will use it for nicer Markdown if installed).

GitHub: https://github.com/jianshuo/ccline | Homepage: https://ccline.jianshuo.dev

Happy to hear your thoughts!