pebrel README

The project's README from github.com/Kuddev/pebrel. As one markdown file: README.md.

Pebrel Titanium icon

Pebrel

A GPU-accelerated terminal, SSH workspace, and home for your AI CLI sessions.

Built with Rust and GPUI for Windows, macOS, and Linux.
Split terminals · SSH & SFTP · Claude Code & Codex workflows · Native document reader

Rust OpenGL ES 2.0+ Windows 10 and 11 macOS 14+ Linux glibc 2.35+ PowerShell GPL-3.0 license

Stars Forks Last commit Discord linux.do

English · 简体中文


Terminal tabs in Pebrel

Claude Code running in Pebrel

OpenCode, Claude Code, and Codex in split panes

💖 Sponsors

Fluxion AI
Fluxion AI
Thanks to Fluxion AI for sponsoring this project! Fluxion AI is one entry point for accessing and managing the world's leading AI models. It serves individual developers, technical teams and enterprises with a unified API; dynamic multi-route scheduling improves availability, and model performance, response time and cost stay transparent. Depending on the model and route, API calls can cost 40%–98% less than official or benchmark prices. Sign up via this link to receive $3 in API credit.

For business cooperation or sponsorship, contact: [email protected]

One Workspace

Pebrel (formerly Nebula) brings local shells, remote hosts, files, and AI command-line tools into a native desktop workspace. Arrange terminals in tabs and splits, follow each agent's activity, and read its output without leaving the application.

Terminals and Sessions

Intelligent Completion

Get suggestions from your current Git repository, project scripts, SSH config, and filesystem—even when you have never run the command before. On Windows, Pebrel also completes registered WSL distributions. These candidates come from Pebrel's own completion engine, without a shell completion plugin or an AI request.

Five commands in a real Windows/PowerShell terminal: Git branches, npm scripts, SSH aliases, WSL distributions, and a quoted filename with cat. Typed one character at a time with the built-in Powerline prompt.

First-use completion for Git, npm, SSH, WSL, and cat in Pebrel

Choose Inline (Tab accepts the suggestion), List (Tab accepts the selected candidate), or Hybrid (→ accepts the inline suggestion; Tab opens the list) in Settings.

How history completion differs

History completion recalls a command you have already executed. Here, echo dep recalls echo deployment finished after its first run. The five examples above discover candidates from the current environment without matching prior commands.

Recalling a previously executed command with history completion

SSH and Files

Native SSH session

AI CLI Workflows

AI activity sidebar

A Native, Configurable Interface

Native formula rendering

Application themes

Download

Choose a package from the latest release.

System Architecture Packages
Windows 10 1809+ / 11 x64 Installer .exe, portable .zip
Linux Preview, glibc 2.35+ x64 .AppImage, .deb, portable .tar.gz
macOS Preview, deployment target 14+ Apple Silicon / arm64 .dmg
macOS Preview, deployment target 14+ Intel / x64 .dmg

Package names follow Pebrel-v<version>-<system>-<architecture>. Windows offers stable installers ending in -setup.exe and portable ZIPs. Linux and macOS are Preview builds, marked -preview before the extension. A legacy-named Windows installer is also supplied for older automatic-update clients.

On Windows, run the installer or extract the ZIP and launch pebrel.exe, keeping the bundled directories together. On Linux, install the DEB or make the AppImage executable. On macOS, open the matching DMG and drag Pebrel into Applications. Ad-hoc-signed macOS builds may require Open Anyway in System Settings > Privacy & Security on first launch. Native macOS CI runs on macOS 15; the deployment target alone does not establish validation on every older OS version.

Pebrel 2.1 connects native tray actions, quick-terminal shortcuts, login startup, and local AI-hook setup on Windows, macOS, and Linux. Linux tray integration uses a status notifier, and Wayland shortcuts use the desktop portal. Windows and macOS provide native update installation; Linux upgrades use its package manager or a new package. See installation details for platform requirements and upgrading an existing Nebula installation.

Self-hosted relay

On your phone, save an SSH host with password or private-key authentication, then select that host in relay setup. For key authentication, the credential field is the private-key passphrase; leave it empty for an unencrypted key. It is not a relay password. After installation, select the SSH host under desktop Settings → Phone connection → Relay, then generate the phone pairing QR code.

See offline relay installation for server requirements, verification and management. The original v2.1.1 Release assets did not include an offline relay kit. A source checkout containing that installer can use mobile/tools/package_manual_relay.py to generate a two-architecture Linux kit and SHA256 sidecar from a verified APK. The tool does not download executables or publish or replace Release assets. Older APKs also need Cargo dependency notices collected from their matching source; the installation guide includes those commands.

Configure

pebrel config init --language en-US
pebrel config check

The generated Lua configuration uses require 'pebrel' and pebrel.config_builder(). Invalid reloads retain the last valid configuration. See the Lua configuration guide for settings and examples.

In Settings → Terminal → Alerts, Notification duration selects Use defaults, 5, 10, 30, or 90 seconds, or Until dismissed. The default preserves existing lifetimes: short toasts last 5 seconds, message banners 90 seconds, and update notices remain until dismissed. The saved preference applies to all newly shown or refreshed in-app cards, independently of the AI-toast visibility switch. Only the latest three cards are retained; newer cards replace older ones without performing their actions, including in persistent mode. Hiding a card never approves or rejects a request or changes task state; requests remain available in their terminals and updates in Settings. System notifications are unchanged. The persisted key is notification_duration, with values default, 5, 10, 30, 90, or persistent. See the notification duration menu.

Build

With the pinned Rust toolchain and the platform dependencies installed:

cargo build --release --locked -p nebula --bin pebrel --features gpui-shell

The internal Cargo package is still named nebula; the application and command are pebrel. GPUI is the product interface. The older renderer is available only through the explicit legacy-shell feature.

Contact

Discord: discord.gg/VFn4rcxmhn

Acknowledgements

Pebrel includes third-party terminal, interface and font components. Their provenance, copyright and license notices are preserved in THIRD-PARTY-NOTICES and licenses/.

Community

⭐ Star History

Star History Chart

pebrel (Kuddev/pebrel)

Searching Database…

3.5K ·GitHub
这是什么?Pebrel 是一款面向 Windows、macOS 和 Linux 的 GPU 加速终端模拟器,把本地 shell、SSH/SFTP 远程访问以及 Claude Code 和 Codex 等 AI 命令行工具整合进一个原生桌面工作区。
它只是个终端,还是更像一个完整的工作区应用?它是一个原生桌面应用(用 Rust 和 GPUI 构建),在同一个窗口里集成了终端模拟器、SSH/SFTP 客户端、文件浏览器,以及对 AI 命令行工具活动的专门跟踪。
要用 AI 功能,需要先装好 Claude Code 或 Codex 吗?需要。AI 命令行工具的工作流图标、活动状态和基于钩子的进度信号,要与单独安装的 Claude Code、Codex 等 CLI 配合;会话恢复也需要受支持的 CLI 和可用的会话标识。
macOS 和 Linux 版做得和 Windows 版一样完善吗?还没有——Windows 提供稳定版安装包,而 Linux 和 macOS 的下载则被明确标记为预览版构建。
手机中继功能会把我的 SSH 凭据经由第三方服务器转发吗?不会。中继是自托管的:你在手机上保存自己的 SSH 主机(用密码或密钥认证),再通过桌面端设置自行连接,全程不涉及外部中继服务。
它的命令补全和 shell 插件有何不同?Pebrel 自带的补全引擎直接从当前环境中给出 Git 分支、npm 脚本、SSH 别名、WSL 发行版和文件名建议,不需要 shell 插件,也不用发起 AI 请求。
能自定义外观和快捷键吗?可以。设置里提供浅色/深色主题、背景、透明度控制,还有一套带校验和热重载的 Lua 配置系统(旧的 TOML 配置也能继续用)。
它能处理到远程服务器的文件传输吗?可以。它提供 SFTP 浏览、上传/下载、带进度和取消功能的文件夹传输,还能在终端旁边进行本地文件浏览和 Git 操作。
Pebrel 免费吗?免费。它以 GPL-3.0 许可证开源,直接通过 GitHub releases 分发。
What are similar projects?shell-rs, WindTerm, AceShell, navop, cmux, herdr-web-ui, omnyssh, Netcatty
Creator
Kuddev
Size
36.9 MB
Stars
3.5K
Age
3mo
Commits · 90 Days