Blocksh is a Warp-style terminal emulator with a built-in AI agent, block-based command output, full PTY support, and a beautiful Catppuccin theme — engineered for the command line era.
What is Blocksh?
Blocksh brings the best ideas from Warp Terminal to an open-source, cross-platform desktop app. Every command becomes a structured block — with its output, exit code, timestamp, and working directory captured cleanly for review.
The built-in AI agent understands your project context, reads your files, and runs commands on your behalf using natural language. No more copying error messages into ChatGPT.
Built with PySide6 and Python, Blocksh is hackable, extensible, and packaged as a single AppImage for Linux.
Built different
Ask questions, generate commands, or let the agent inspect your project files and run tasks autonomously — powered by Claude.
Every command is a clean, scrollable card with its stdout, stderr, exit code, timestamp, and working directory — always at a glance.
Run vim, nano, htop, ssh, and even Claude Code natively — the PTY renderer handles complex ANSI sequences and interactive programs.
Blocksh auto-registers git repos, Node, Python, Rust, and Go projects. Browse project histories and re-run past commands from the sidebar.
Ships with Catppuccin Mocha and Latte. Drop any JSON theme file in ~/.blocksh/themes/ for instant live preview.
Persistent SQLite history with full-text search, favorites pinning, and per-project command logs — never lose a working command again.
See it in action
A clean, dark interface that stays out of your way — and shows you exactly what you need when you need it.
Aesthetics matter
Soft white background with warm pastel accents — perfect for daylight
Deep dark background with warm pastel accents — the default Blocksh experience
Get it running in minutes
No Python or dependencies required — everything is bundled. One command installs Blocksh and adds it to your application launcher.
curl -fsSL https://raw.githubusercontent.com/rhaymisonbetini/Blocksh/main/install.sh | bash
Installs the AppImage, creates the icon, and adds Blocksh to your app launcher. Search Blocksh in GNOME Activities or KDE after running.
wget https://github.com/rhaymisonbetini/Blocksh/releases/latest/download/Blocksh-x86_64.AppImage
chmod +x Blocksh-x86_64.AppImage
./Blocksh-x86_64.AppImage
All user data lives in ~/.blocksh/ — created fresh on first launch.