OPEN SOURCE / LOCAL-FIRST / macOS

CODE.
COLLECT.
EVOLVE.

Turn Claude Code and Codex usage into growth energy. Keep your work on your Mac, and raise 256 creatures to the rhythm of your code.

Install with Homebrew View on GitHub

v0.3.0 HOMEBREW · 240 CREATURES · CURRENT MAIN + DEX · 256

punchgrow://local
Actual PunchGrow menu popover showing a creature, token balance, and growth actions
v0.3HOMEBREW · 240
256MAIN + PUBLIC DEX
LOCALPRIVACY FIRST
MITOPEN SOURCE

01 / THE LOOP

YOUR CODE MAKES
A WORLD GROW.

Usage numbers become tokens. Tokens unlock choices in collecting and growing. Every creature begins as a tiny PROCESS.

  1. 01

    CODE

    Read new Claude Code and Codex usage from local logs.

  2. 02

    COLLECT

    Spend earned tokens to discover 64 starting lineages.

  3. 03

    GROW

    Feed creatures and shape their evolution through choices.

  4. 04

    EXPAND

    Follow branches and mutations toward a 256-entry dex.

Menu popover showing creature growth and token balance
01Grow from the menu barTokens, food, and gacha in one place
Rarity guide separating current grade from lineage potential
02Honest growth oddsCurrent grade and lineage potential, separated
Evolution dex showing owned stages and locked future branches
03Evolution that remembersPast forms and future branches at a glance

02 / ELEMENTAL ORIGINS

THE FIRST FOUR
ROOT COMMANDS.

STATE, EXECUTE, ROUTE, STORE. Four powers split at the world's first boot, each evolving from PROCESS to ORIGIN. Browse all 256 creatures

STATEPG-244
Nervasil, the Water ORIGIN

WATER / ORIGIN

Nervasil

The first wave, preserving every moment the world forgot.

EXECUTEPG-248
Karmag, the Fire ORIGIN

FIRE / ORIGIN

Karmag

The first will, igniting possibility and making it real.

ROUTEPG-252
Velaum, the Wind ORIGIN

WIND / ORIGIN

Velaum

Ruler of the paths, carrying the first breath between beings.

STOREPG-256
Grandor, the Earth ORIGIN

EARTH / ORIGIN

Grandor

The first foundation, bearing the results of every execution.

03 / PRIVACY BY DESIGN

READ THE NUMBERS.
NEVER THE CONTENT.

PunchGrow runs locally. Collection starts only after explicit opt-in. Prompts, responses, source code, commands, project names, and account details are never stored or transmitted as game data.

Read the privacy architecture
$ punchgrow privacy --inspect

✓ token_count accepted

✓ timestamp accepted

× prompt never stored

× source_code never stored

× file_path never stored

RESULT: LOCAL ONLY

04 / BUILT IN THE OPEN

EXPLORE IT.
IMPROVE IT. GROW IT.

The shipping app, public site, local web experiment, and product records have explicit boundaries, so a first-time contributor can find the right starting point quickly.

SHIPPING APP

macos/

The released SwiftUI menu-bar app, tests, and build scripts.

Swift 6 · macOS 14+
PUBLIC SITE

website/

This GitHub Pages site and the public 256-creature dex.

HTML · CSS · JavaScript
LOCAL MVP

web/ + server/

A local Docker experiment, not an internet-hosted product.

TypeScript · PostgreSQL
KNOWLEDGE

docs/ + 문서/

User guides and public QA alongside product decisions and design rules.

Guides · Decisions · PRD
Browse the source Repository map Start contributing

05 / INSTALL

START ON
YOUR OWN MAC.

You need an Apple Silicon Mac running macOS 14 or later. Homebrew v0.3.0 contains 240 creatures; current main source and the public dex contain 256.

HOMEBREW / v0.3.0 · 240 CREATURES
brew tap yoonsundo/punchgrow https://github.com/yoonsundo/punchgrow
brew trust yoonsundo/punchgrow
brew install --cask punchgrow
xattr -d com.apple.quarantine /Applications/PunchGrow.app

This 2026-08-07 release contains 240 creatures. It is ad-hoc signed, so clear quarantine before first launch; skip brew trust before Homebrew 6.

SOURCE BUILD / CURRENT MAIN · 256 CREATURES
git clone https://github.com/yoonsundo/punchgrow.git
cd punchgrow/macos
./scripts/build-app.sh
open .build/PunchGrow.app

This current development build contains the 16 later additions and requires Full Xcode. See the usage guide for details.

READY TO GROW?

TODAY'S CODE.
TOMORROW'S ORIGIN.

PUNCHGROW ON GITHUB