Quickstart

Mallea is in early development on macOS. The source repository currently requires collaborator access, and a public download is not available yet.

You can explore the malleable software idea and first-app workflow now. The build steps below are for existing collaborators.

Prerequisites

Install Bun 1.4.0, Zig 0.16.0, Node 24 or later with npm, Python 3, Git, and the macOS native build toolchain.

The repository pins its Native SDK and applies its required patches during the shell build. You do not need to patch the SDK by hand.

Get the source

 git clone https://github.com/ankitiscracked/mallea.git
 cd mallea
 bun install

Launch Mallea

Make Zig 0.16.0 available through ZIG, or install it at the launcher's default location, ~/.native/toolchains/zig-0.16.0/zig.

bun run shell

Development launches are passive by default: the app opens without taking keyboard focus. To bring it to the foreground explicitly:

bun run shell --foreground

Connect an agent

Mallea supports Pi RPC, Claude Code, and Codex app-server adapters. Install and authenticate the runtime you want to use, then select it when starting a conversation.

Model access and runtime permissions are managed by that runtime. Mallea does not supply model credits.

Make your first tool

Start a conversation in your workspace and describe something small and useful:

Build me a reading tracker. I want a title, an author, and a reading status for each book.

Then use it and ask for a change. Your first app gives a more complete example.

For the full development setup and verification commands, collaborators can read docs/README.md in their checkout.