Open Source Terminal GUI
ShellFrame
An AI terminal anyone can pick up.
Born from a designer's need. Now the whole team uses it.
Origin Story
My collaborator is a designer. She watched me fly through tasks with Claude Code and Codex in the terminal and wanted to try it herself. But she immediately hit a wall: you can't paste images in a terminal.
IDEs like Windsurf and Cursor let you paste screenshots directly to ask AI questions, but the raw terminal can't do that. Having to save an image, type out the file path, then reference it — that single extra step killed the motivation.
So I built a ultra-lightweight GUI wrapper — not Electron-heavy, but Python + native OS WebView. Fast startup, tiny memory footprint. Cmd+V to paste images, multi-tab to manage different projects, and a Telegram bridge for remote access from your phone.
After completing it, I introduced ShellFrame to my colleagues. Designers and PMs benefited just as much. They no longer had to face the intimidating black-and-white terminal — ShellFrame lowered the barrier to AI CLI tools down to "if you can use a chat app, you can use this."
Problem & Solution
The Problem
- x Terminals can't paste images
- x Non-engineers fear command lines
- x Can't use AI tools away from desk
- x Electron is bloated, VS Code is overkill
The Solution
- > Cmd+V to paste screenshots instantly
- > Clean GUI with one-click presets
- > Telegram bridge for mobile access
- > Native WebView — lightweight & fast
Key Features
📋
Screenshot Paste
Cmd+V to paste images directly into the terminal, auto-converted to Base64 for AI, with inline preview.
📑
Multi-Tab
Each tab runs an independent PTY session. Manage multiple projects simultaneously without interference.
📱
Telegram Bridge
One bot manages all tabs with /list, /1, /2 commands. Control your AI sessions from your phone.
🌐
Cross-Platform
Mac, Windows, and Linux. macOS .app bundle, Windows ConPTY for full terminal experience.
🔄
Auto Update
Silent background update checks, one-click hot reload without breaking active sessions.
🌏
i18n
Full internationalization with Traditional Chinese and English, ready for a global audience.
Tech Stack
Frontend
xterm.js terminal
Native OS WebView
Zero Electron dependency
Backend
Python + pywebview
PTY / ConPTY
WebSocket communication
Bridge
Telegram Bot API
Multi-session routing
Zero dependencies (urllib)
Deploy
One-line install script
Git-based auto-update
macOS .app bundle
Making AI Tools Belong to Everyone
Claude Code and Codex are powerful AI tools, but they live inside the terminal — for non-engineers, that's an invisible wall.
ShellFrame tears that wall down.
When a designer can paste a screenshot to ask AI about layout.
When a PM can use Telegram to ask AI to organize data remotely.
When a new hire doesn't need to learn the command line to start using AI.
That's what tools should be: serving people, not the other way around.
Open Source MIT — free for everyone