Supports agentic workflows
Add the Codea skill to your local AI tooling to let agents inspect devices, pull code, push changes, and help you build directly in Codea
Run Codea from your terminal
Install projects, pull files, push updates, capture screenshots, and talk directly to running Codea devices and runtimes without leaving the command line
brew install twolivesleft/tap/codea
macOS, Linux, and WSL install via Homebrew. Windows is available as an MSI, or with PowerShell: installer script.
$ codea discover
1. StudioBook.local (127.0.0.1:18513)
Saved 127.0.0.1:18513 as profile 'default'.
$ codea status
Host: 127.0.0.1
Port: 18513
Project storage: collections
$ codea ls
Examples/Flappy
Examples/SoundWave
Craft/Voxel Terrain
Add the skill
Connect Codea to your favorite AI agent
If you already use the `skills` toolchain, add the skill to give your local tools direct Codea integration
npx skills add twolivesleft/codea-cli/skill
Install on macOS / Linux / WSL
One command, and you're in
brew install twolivesleft/tap/codea
Install on Windows
Use the latest MSI or bootstrap with PowerShell
powershell -c "irm https://github.com/twolivesleft/codea-cli/releases/latest/download/codea-cli-installer.ps1 | iex"
Codea Runner
A native macOS app that runs your Codea projects. Use the CLI with it so your agent can iterate on your machine
Requires macOS 15 or later
Want the full docs?
Find our manual and releases below
Learn more