0.3.1 - 2026-11-01

Release Notes

Fixed

• codea pull writes binary files (images, sounds, ROMs) as the original bytes
  instead of the base64 text Codea sends them as.
• codea push sends binary files intact. A binary file that happened to be
  valid UTF-8 used to be sent as text and was silently not written.

Changed

• pull and push transfer every file as base64 when Codea supports it (the
  encoding argument of the readFile and writeFile tools). With older Codea
  builds they fall back to choosing text or base64 by extension, as Codea does.

Install codea-cli 0.3.1

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/twolivesleft/codea-cli/releases/download/v0.3.1/codea-cli-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install twolivesleft/tap/codea

Download codea-cli 0.3.1

File	Platform	Checksum
codea-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codea-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codea-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
codea-cli-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
codea-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

0.3.0 - 2026-10-26

Release Notes

Install codea-cli 0.3.0

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/twolivesleft/codea-cli/releases/download/v0.3.0/codea-cli-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install twolivesleft/tap/codea

Download codea-cli 0.3.0

File	Platform	Checksum
codea-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codea-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codea-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
codea-cli-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
codea-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

0.2.0 - 2026-09-24

Release Notes

Added

• codea screen-size [preset] reads or sets the screen size of the running
  project's viewer, so a project can be checked at another aspect ratio or
  orientation. Presets are match-display, iphone-portrait,
  iphone-landscape, tv and square. Reading it also reports the viewer's
  current pixel size, taken from its laid-out bounds rather than the preset's
  nominal size. Needs a Codea build that
  provides the setScreenSize and getScreenSize Air Code tools.

Install codea-cli 0.2.0

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/twolivesleft/codea-cli/releases/download/v0.2.0/codea-cli-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install twolivesleft/tap/codea

Download codea-cli 0.2.0

File	Platform	Checksum
codea-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codea-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codea-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
codea-cli-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
codea-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.6

Install codea-cli 0.1.6

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/twolivesleft/codea-cli/releases/download/v0.1.6/codea-cli-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install twolivesleft/tap/codea

Download codea-cli 0.1.6

File	Platform	Checksum
codea-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codea-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codea-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
codea-cli-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
codea-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.5

Install codea-cli 0.1.5

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/twolivesleft/codea-cli/releases/download/v0.1.5/codea-cli-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install twolivesleft/tap/codea

Download codea-cli 0.1.5

File	Platform	Checksum
codea-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codea-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codea-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
codea-cli-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
codea-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.3

Install codea-cli 0.1.3

Install prebuilt binaries via Homebrew

brew install twolivesleft/tap/codea

Download codea-cli 0.1.3

File	Platform	Checksum
codea-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codea-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codea-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.2

Install codea-cli 0.1.2

Install prebuilt binaries via Homebrew

brew install twolivesleft/tap/codea

Download codea-cli 0.1.2

File	Platform	Checksum
codea-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codea-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codea-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.1

Install codea-cli 0.1.1

Install prebuilt binaries via Homebrew

brew install twolivesleft/tap/codea

Download codea-cli 0.1.1

File	Platform	Checksum
codea-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codea-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codea-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

v0.1.0

Install codea-cli 0.1.0

Install prebuilt binaries via Homebrew

brew install twolivesleft/tap/codea

Download codea-cli 0.1.0

File	Platform	Checksum
codea-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
codea-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
codea-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum