GitHub - patoles/ravenry: The open-source terminal for Claude Code and Codex: your agents in real terminals, on one board, answered from your phone.

GitHub

3 min read Original article ↗

Ravenry logo: a white raven with a blue eye

The open-source terminal for Claude Code and Codex.

Ravenry runs your coding agents in real terminals, on your Mac and on your other machines over ssh, and puts every session on one board, sorted by what needs you. When an agent needs a choice, a go-ahead or a secret, it stops and asks, and the question shows up on your Mac and on your phone at the same time. Answer from either one.

The Ravenry Mac app: the board of sessions beside a terminal, and the phone with the same question

  • A real terminal. Native on the Mac (Swift and Metal), with tabs and splits. Sessions keep running when you quit or update the app.
  • One board. Every session, grouped as Needs you, Working and Idle, with its live screen.
  • Your phone. The Android app shows every project and answers from the notification; an iPhone gets the alerts.
  • Your machines. Linux and Mac machines over ssh, on the same board.

A short video: docs/media/ravenry-30s.mp4.

Download

Ravenry is in an early test: get the Mac app (Apple silicon, macOS 13 or later) and the Android app from https://patoles.github.io/ravenry/. The Mac app updates itself. It works with Claude Code and Codex, installed and signed in.

Build from source

Each app's README has the details. You need Node 22 or later for all of them, and npm ci at the root of the repository first.

What Needs Build
ravenryd, the daemon (daemon/) Go, Zig 0.17 or later, git cd daemon && make && make test
The Mac app (apps/macos/) macOS 13 or later, Xcode, XcodeGen, Go, Zig cd apps/macos && scripts/build.sh
The Linux desktop app (apps/desktop/) Linux or macOS, Go, Zig npm run desktop to run it; npm --workspace @ravenry/desktop run pack -- --linux for an AppImage and a .deb
The Android app (apps/android/) Java 17, the Android SDK cd apps/android && ./gradlew assembleDebug
The iPhone and iPad app (apps/ios/) Xcode, XcodeGen cd apps/ios && scripts/build.sh (the simulator)
The hub, the board's server (hub/) macOS cd hub && npm ci && npm start (http://localhost:4600)

The repository

Folder What
daemon/ ravenryd, the Go daemon on every machine: terminals, screen state through libghostty-vt, waits and input for agents, the protocol server, and its command line.
hub/ The hub, in Node: the board and the always-on server every app talks to.
apps/macos/ The native Mac app, Swift and AppKit, drawing the daemon's screen with its own Metal renderer.
apps/desktop/ The Electron desktop app, for Linux.
apps/android/, apps/ios/ The phone apps: thin shells around the phone board.
apps/phone/ The phone board's own screens, shared by the phone apps.
shared/ What every client shares: words, icons, themes, design tokens, settings.
packages/ The protocol spec, the client libraries and the page format, for plugins and other clients.
site/ The download page.
docs/ ARCHITECTURE.md, FEATURES.md (every feature and where each app stands), PHONE.md, RENDERING.md, PUBLISHING.md.
tools/ The repository's checks: the personal-data audit, the feature list check, the third-party notices.

Contributing

Issues and pull requests are welcome: CONTRIBUTING.md says how. Report a security problem privately, as SECURITY.md says.

Licence

Ravenry is free software. Everything outside packages/ is under the GNU General Public License, version 3 only (LICENSE); packages/ is under the Apache License, Version 2.0 (packages/LICENSE), so plugins and clients written against it can use any licence. A commercial licence for the GPL parts is available from the copyright holder. LICENSING.md has the details, THIRD_PARTY_NOTICES.txt lists the projects the apps include, and TRADEMARK.md covers the name and logo.