Skip to content
HardwareLab
Agent Desk GadgetsIntermediate · Our suggestion

ClaudeBerry

The creator: @0xProbabillityOriginal post

A BlackBerry Bold becomes a pocket Claude Code terminal

Full build guide

ClaudeBerry
Image hot-linked from the project's GitHub repository.

By @0xProbabillity

View original on GitHub View original on X View cobanov/berryssh on GitHub
Posted
GitHub stars
45 (GitHub)

What you need

Skill level
Intermediate
License
GPL-2.0-or-later (source)

Parts

  • BlackBerry OS 7 or 7.1 phone (Bold 9900 or 9930 is the target; Bold 9790 is also confirmed)
  • SSH server (Linux VPS, home server or Raspberry Pi with OpenSSH 6.5 or newer)
  • macOS or Linux build computer (JDK 8 or Docker, Python 3 and curl)
AI model or service
Claude Code, faster-whisper

Prices, notes and sources: Parts and requirements

Steps

Skill level
Intermediate
  1. Create a dedicated Ed25519 key for the phone, copy its public key to the server, and install tmux and Claude Code there.
  2. Clone ClaudeBerry, fetch its build dependencies, and run make_preset.sh with the server login and phone key.
  3. Build with JDK 8 or Docker to produce claudeberry.jad and claudeberry.jar.
  4. Copy both files to the phone over Bluetooth or USB, open the JAD, and allow the requested permissions.
  5. Open ClaudeBerry, connect to tmux, and start Claude Code. Optionally install the voice helper on the server.

Full instructions: View original

Like this build? Get the weekly builds

Every Thursday: the 5 best gadget hacks you can copy. Free.

Built something? Submit a build

Overview

ClaudeBerry is an open-source SSH client tuned for running Claude Code from a BlackBerry OS 7 phone. The creator, @0xProbabillity, adds persistent tmux sessions, agent-friendly keys, modern terminal colour and voice prompting transcribed by Whisper on the user's own server.

What it does

  • Opens an SSH session to a server the user owns and rejoins the same tmux session after a dropped connection.
  • Adds an on-screen key bar and quick panel for keys Claude Code needs, including Esc, Tab, Ctrl, arrows and Enter.
  • Records a voice prompt on the phone and has faster-whisper transcribe it on the user's server before placing the text at the prompt.

Parts and requirements

PartSpec / notesNeededPrice
BlackBerry OS 7 or 7.1 phone Bold 9900 or 9930 is the target; Bold 9790 is also confirmedRequired
SSH server Linux VPS, home server or Raspberry Pi with OpenSSH 6.5 or newerRequired
macOS or Linux build computer JDK 8 or Docker, Python 3 and curlRequired
  • RAM: About 1 GB free on the server for voice input
  • OS: BlackBerry OS 7 or 7.1; Linux on the server
  • Network: Wi-Fi or mobile data the phone can use
  • Computer for setup: macOS or Linux with JDK 8 or Docker, Python 3 and curl
  • About 1 GB free disk on the server for voice input
  • An Ed25519 SSH key for the phone

How it works

The phone opens an SSH session to the user's server and starts or rejoins a tmux session named bb. Voice uses a second short SSH connection: the phone sends audio to berryssh-transcribe, faster-whisper runs on the server, and the returned text is typed at the prompt without pressing Enter.

LayerComponentRuns on
Phone clientClaudeBerry, based on berryssh BlackBerry OS 7
Terminal sessionOpenSSH and tmux User's server
Coding agentClaude Code User's server
Voice transcriptionfaster-whisper User's server

Setup effort

Skill level
Intermediate

Limits and caveats

  • Only the Bold 9900 and 9790 are confirmed; BlackBerry 10 and Android BlackBerry phones cannot run this Java ME app.
  • A preset build contains the phone's private SSH key, so it must be copied only to the user's phone and never published or served over the network.

Hardware

  • BlackBerry Bold 9900 or another BlackBerry OS 7 phone
  • Linux server, home server or Raspberry Pi

More Raspberry Pi builds

Credits and links

Sources

  1. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L27-L34
  2. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L53-L64
  3. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L90-L92
  4. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L118-L131
  5. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L132-L136
  6. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L134-L136
  7. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L116-L136
  8. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L41-L48
  9. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L104-L114
  10. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L27-L31
  11. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L138-L160
  12. github.com/0xProbabillity/claudeberry/blob/6d7395d9fb56c8c6c10cb06cf1a40be03c3a1ea3/README.md#L157-L160

This page is a short summary written by HardwareLab. Build steps, code and photos belong to the creator; follow “View original” for the full project.

Featured? Add this badge

Built this? Paste the badge into your README. It links back to this page.

Featured on HardwareLab

Markdown

[![Featured on HardwareLab](https://hardwarelab.dev/badge.svg)](https://hardwarelab.dev/projects/claudeberry/?utm_source=badge&utm_medium=referral&utm_campaign=launch_2w)

HTML

<a href="https://hardwarelab.dev/projects/claudeberry/?utm_source=badge&utm_medium=referral&utm_campaign=launch_2w"><img src="https://hardwarelab.dev/badge.svg" alt="Featured on HardwareLab" width="188" height="20"></a>

Related builds

All 21 in Agent Desk Gadgets