Repository navigation
blockterm 0.1.0
First release. An open-source terminal that wraps your real shell with command blocks and an AI agent that types only what you approve.
npm i -g blockterm
# Linux: npm i -g --allow-scripts=node-pty blockterm (needs python3, make, g++)Requires Node 24 or newer. Then run blockterm setup.
What's in it
- Your real shell (ssh, vim, anything) on Windows, macOS and Linux.
- Command blocks in bash, zsh, PowerShell 7 and Windows PowerShell 5.1: command, exit status, duration, output.
- Block selection with
ctrl+↑/ctrl+↓: copy command (c), copy output (o), rerun (r), explain error (e). ctrl+kagent line (Anthropic, OpenAI or any OpenAI-compatible endpoint, including Ollama and LM Studio); every keystroke needs your approval, Enter approves.#suggestions at an empty prompt.- Drag to select and copy in the shell or agent pane; prompt editing and history;
/clearorctrl+l. F1key help;blockterm setup,blockterm doctor,blockterm update.
Known issues
- On Windows the approval card can show the TERM name instead of the shell. Fixed on
main; ships in 0.1.1. - WSL bash runs without blocks; PowerShell 7 blocks are not on macOS yet.