v0.4.0 · MAY 2026

Iris Code

The god of sub-messaging — packaged as a calm, fast Windows desktop app. Free, MIT licensed, no account required.

Download for Windows (x64) Download for Windows (ARM64) Install instructions

≈ 90 MB · Windows 10 / 11 · NSIS installer · v0.4.0 on x64 and ARM64

Not sure? Press Win+Pause — if "System type" says ARM-based PC, choose ARM64; otherwise choose x64.

Other platforms

Mac & Linux coming soon

Native builds for macOS and Linux are landing in v0.4. Sign up on GitHub for release notifications.

Windows 10 / 11 · x64 Available · NSIS installer
macOS v0.5 · signed DMG
Linux v0.5 · AppImage / deb

Before you install

Iris Code drives the official Claude Code CLI under the hood. You'll need it installed and authenticated before first launch. From a terminal, run: 

npm install -g @anthropic-ai/claude-code
claude auth login

Full instructions are in the Claude Code documentation. Iris Code detects the CLI automatically on first launch.

Installation

Five quiet steps to a coding cockpit.

  1. Pick the right installer for your CPU

    Most Windows laptops and desktops are x64 (Intel / AMD) — click the gold button to download Iris Code Setup 0.4.0.exe. If you're on a Surface Pro X, a Copilot+ PC, or another Snapdragon / ARM machine, use the ARM64 button instead — that downloads Iris Code Setup 0.4.0 (ARM64).exe.

  2. Run the installer

    Double‑click the .exe. Windows will ask for permission to make changes — accept.

  3. Pass the SmartScreen warning

    Because v0.4.0 isn't code‑signed yet, Microsoft Defender SmartScreen may show a blue prompt. Click More info, then Run anyway. Signed builds are scheduled for v0.5.

  4. Choose an install location

    The default is fine. Iris Code installs into your user profile, so admin rights aren't required.

  5. Launch & complete the first‑run wizard

    On first launch, the wizard checks for the claude CLI, lets you store an API key in the encrypted vault, and offers a tour of the keyboard shortcuts. Two minutes and you're in.

Verify your download

Checksums

Confirm the installer hasn't been tampered with. Compare against these published hashes.

Artifact Algorithm Hash
Iris Code Setup 0.4.0.exe x64 SHA‑256 dbf83d40efa790aeb9000a751ecd25f34db4c89762b1aea3425ae470049200d0
Iris Code Setup 0.4.0 (ARM64).exe arm64 SHA‑256 18765ab67512b5eaa10efc6f8dabadd25afa11ed7aa778ffe52cccfe3b5c68f3

To verify locally on Windows: Get-FileHash .\"Iris Code Setup 0.4.0.exe" -Algorithm SHA256. Hashes are also published in SHA256SUMS.txt alongside the installer on the GitHub release page.

Release notes

What's new in v0.4.0 — Telegram Remote Agent

One headline feature: DM your personal Telegram bot to drive Claude Code on your desktop, from anywhere.

added

Telegram Remote Agent

Bring-your-own-bot — one user, one bot, no shared infrastructure. Token encrypted at rest via Electron safeStorage with an AES-GCM fallback.

added

6-digit pairing flow

No copy-pasting chat IDs. Type one code in Telegram and the bridge locks to your account.

added

Per-chat allowlist

Inbound messages from any other chat are dropped silently. Enforced on every single update.

added

Auto-reconnect

Exponential backoff on network or Bot API failures. Survives flaky hotel Wi-Fi and Telegram outages.

added

MarkdownV2 replies

Agent output is properly escaped and chunked at Telegram's 4096-character ceiling — no broken formatting, no truncated messages.

added

Slash commands

/new resets context, /stop cancels the current run. The bot speaks the same language as the desktop UI.

Under the hood

  • New module — lib/telegram/ (index.js, api.js, markdown.js). Pure Node https; zero new runtime dependencies.
  • Token at rest — its own telegram-token.json (chmod 600 on POSIX) so encryption-backend changes can't corrupt unrelated settings.
  • New settings key — telegram (enabled, botUsername, allowedChatId, chatAgentId). The bot token itself never touches settings.json.
  • New IPC surface — telegram:status, telegram:set-token, telegram:start-pairing, telegram:test-message, plus a ui:telegram-status push event for live panel updates.
  • New onboarding step — "Set up with Telegram for easy agent access (optional)" — deep-links to the panel.
  • 15 new tests — tests/telegram.test.js covers MarkdownV2 escaping, chunking, pairing, allowlist, agent routing.
  • New doc — docs/telegram.md.

Compatibility

  • v0.3.0 settings auto-upgrade. The telegram block defaults to disabled, no token, no paired chat — existing users see no behavior change until they enable the bridge.

Known limitations

  • Installer is not yet code‑signed. SmartScreen will warn — signing is scheduled for v0.5.
  • Both x64 and ARM64 are available for v0.4.0 — pick the one that matches your CPU.
  • macOS and Linux native builds are scheduled for v0.5.

Ready when you are.

v0.4.0 is the most reachable version yet — your desktop, in your pocket. Try it for an hour.

Download for Windows (x64) Download for Windows (ARM64) Read the docs