ccline — zsh plugin: type a thought at your prompt, LLM answers and runs the command

[jianshuo]

I built ccline — a zsh plugin that uses the claude (or codex) CLI as a natural language shell assistant.

The approach is different from other AI shell tools: instead of adding a new command, ccline hijacks command_not_found_handler. When you type something that is not a valid shell command:

• One word → treated as a normal typo
• Two or more words → sent to your LLM CLI, answer rendered as Markdown

Any shell commands in the response appear in an interactive arrow-key menu; selecting one runs it in your live shell (so cd, export, and history persist — unlike a subprocess).

The simonw/llm project is exactly the kind of backend this could use too (with a small adapter). Currently supports claude CLI (preferred) and codex CLI (fallback), auto-detected.

$ 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

Install:

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

GitHub: https://github.com/jianshuo/ccline