diri
Download
Getting started

Install

Install diri on macOS with the DMG or Homebrew, understand how updates arrive, try the Linux and iPhone betas, and remove every local file.

diri is a native app for macOS 15 or newer. A Linux beta runs on x86_64 Ubuntu, and an iPhone companion is in beta. Agents are installed separately; diri runs the CLIs and accounts already on your machine.

macOS

The macOS build is universal (Apple silicon and Intel), signed with a Developer ID, and notarized.

Homebrew

Terminal
brew install --cask cristicretu/diri/diri

DMG

  1. Download the latest DMG from GitHub Releases.
  2. Open it and drag diri to Applications.
  3. Open diri. The first launch checks which agents are installed and offers to install one if none are. See the Quickstart.
RequirementValue
macOS15 or newer
ArchitectureApple silicon or Intel (one universal app)
AgentsInstalled separately, for example Claude Code or Codex

Updates

diri updates itself from the same GitHub release feed. It checks 20 seconds after launch and then every 6 hours. Downloads are verified before they are offered: the code signature, the Team ID and bundle identifier must match the running app, Gatekeeper must accept the notarization, and the version must match the one the feed promised. Only newer versions are offered.

diri never quits or relaunches by itself, because it is holding your sessions. When an update is ready:

  1. The sidebar footer shows Restart to update to followed by the version.
  2. Click it to install and relaunch now, or just quit diri normally. A normal quit installs the update without reopening the app.
  3. Running agents keep running. The background Engine is replaced with the new one, and every session reconnects.

To check by hand, open the command palette (⌘K) and run Check for Updates…. It reports "up to date" instead of staying silent.

Update settings

Open Settings → General → Software updates.

SettingWhat it does
Update automaticallyDownload verified GitHub releases and install when diri quits.
Check NowRun a check right away. Becomes Download or Restart when an update is waiting.
Skip this versionHide the offered release until a newer one is available.

To install a specific release, including an older one, Option-click the update button. A Switch version list shows the releases the feed still carries, with Install next to each. Choosing one turns off Update automatically so it is not replaced on the next check. Turn it back on to return to the latest release.

Linux beta

diri runs on x86_64 Ubuntu 22.04 and 24.04 under Wayland or X11. Linux packages are not included in every release, so check the release list for one with Linux assets.

RequirementValue
DistributionUbuntu 22.04 or 24.04, x86_64 (glibc 2.35 or newer)
DisplayWayland or X11
GraphicsA Vulkan 1.3 driver
Packages.deb and .AppImage

Verify the download against the SHA256SUMS file from the same release:

Terminal
sha256sum --ignore-missing --check SHA256SUMS

Each Linux file also has a Sigstore bundle. The Linux guide has the cosign verify-blob command that proves a file was built by the project's CI.

Install the Debian package with APT so its dependencies resolve. It adds the desktop entry and the diri, dirijor and dirijor-mcp commands:

Terminal
sudo apt install ./diri_<version>_amd64.deb

Or run the AppImage directly:

Terminal
chmod +x diri_<version>_amd64.AppImage
./diri_<version>_amd64.AppImage

diri does not update itself on Linux. Settings shows the installed version; update by installing a newer package the same way.

Linux limits

  • No aarch64 packages.
  • No native tray or notification actions. Approvals and status still work inside diri.
  • No automatic in-app updates.
  • No iPhone companion or remote port forwarding.
  • Start at login is hidden.

Shortcuts use Ctrl where macOS uses ⌘. See Keyboard shortcuts.

iPhone companion (beta)

The iPhone app starts, watches and answers sessions on your Mac over Tailscale. It needs a signed build of the app; there is no App Store release.

  1. On the Mac, open Settings → Phone access and click Check this Mac. Follow the Tailscale guidance until the check passes.
  2. On the iPhone, install Tailscale and sign in with the same account.
  3. On the Mac, click Enable phone access & show code. On the iPhone, tap Scan pairing code, or paste the link from Copy pairing link.
  4. Keep diri open and the Mac plugged in with the lid open. Closing the lid or quitting diri disconnects the phone.

The pairing code controls every session on that Mac, so do not share it. Turning access off closes existing connections, and enabling it again makes a new code. Build details are in ios/README.md.

Local data

PlatformPathContents
macOS~/Library/Application Support/DirijorEngine state, session records, logs
macOS~/Library/Application Support/diriApp data
macOS~/Library/Caches/diri/updatesDownloaded updates and install.log
Linux~/.local/share/diriData and PTY holders
Linux~/.local/state/diriSession state and logs
Linux~/.config/diriHost config and manifest overrides
Linux~/.cache/diriCache

On Linux the usual XDG_* variables override these roots.

To check the Engine, agent discovery and state file without opening the window, run dirijor doctor. On macOS the command lives inside the app:

Terminal
/Applications/diri.app/Contents/Resources/bin/dirijor doctor

Uninstall

Quitting diri does not stop your agents. Each session runs in its own background process so it survives the app closing.

  1. Close the sessions you want to stop (⌘W), then quit diri.
  2. On macOS, delete diri from Applications, or run brew uninstall --cask diri if you used Homebrew. On Linux, run sudo apt remove diri or delete the AppImage.
  3. To remove your sessions and settings too, delete the data folders listed above.

Package removal never deletes your sessions or preferences on its own. Your project folders and any git worktrees are not touched.