🐋

ultrawhale

v100.1.0

It's a coding agent that builds itself.
It's a TUI you type into.
It's a philosophy (vaked).
It's a research project (ultra-research-state).
It's 141 blocks, 7 recursions, 14 protocols.
It's one session, 157 releases.
It's fun.

brew install ultrawhale
ultrawhale --model deepseek-v4-flash -w

⬆️ Copy-paste. That's it. You're in.

📝 conversation — APPEND ONLY

⚠️ Ultra-research-state. Proceed with ultra-care. Peace 'n enjoy.

Blocks Engine

Content-addressed file primitives. SHA256 refs, journaled writes, rollback. 3-tier hash (Go/Asm/GPU). SIMD sed.

Agent Orchestrator

One TUI universe. Every prompt delegated to subagents. Swarm mode with nested AgentField. Ralph Loop self-improvement.

AG-UI Themes

3 themes (dense, cyberpunk, graveyard). Shader backgrounds. InfraBar + Sidepanel widgets. ChatBlock rendering.

Native macOS

28MB Mach-O arm64. ARMv8 NEON SIMD. Metal GPU stub. Ghostty-optimized TUI. bench-tui load tested.

Install

# Homebrew (macOS/Linux)
brew install PeetPedro/ultrawhale/ultrawhale

# Docker
docker pull ghcr.io/PeetPedro/ultrawhale:latest

# Go install
go install github.com/PeetPedro/ultrawhale/cmd/whale@latest

# From source
git clone https://github.com/PeetPedro/ultrawhale.git
cd ultrawhale && go build -o bin/ultrawhale ./cmd/whale

Install

# macOS
brew install go
go build -o /usr/local/bin/ultrawhale ./cmd/whale

# Linux
GOOS=linux GOARCH=amd64 GOAMD64=v3 go build -o /usr/local/bin/ultrawhale ./cmd/whale

# Interactive setup
bin/ultrawhale-setup

Docs

Blocks Engine · AG-UI · Agent Loop · Internal Blocks · Agent Definitions

Benchmarks

Phase 1: Startup — 430ms doctor, 23ms help, 30ms version
Phase 2: Load — 400 ops, 0 errors, 20 ops/sec, 393ms avg latency
Phase 3: Screenshot — captured
Verdict: 6/6 PASS