⚡ CYBERPUNK THEME · ASCII-live demo coming soon ⚡
A coding agent that builds itself. 150 blocks. 7 recursions. 14 protocols. v100.1.0.
brew install peterlodri-sec/ultrawhale/ultrawhale
ultrawhale --model deepseek-v4-flash -w╔══ LIVE ═══════════════════════════════════════╗
║ 🟢 v100.1.0 · M1/arm64 · 150 blocks ║
║ 🐋 SACRED: ● 1:1 · perm: GRANTED ║
║ 📡 HF: PeetPedro/ultrawhale-dogfood ✅ ║
║ 🐘 @vakedbot@social.crabcc.app ║
║ 🌐 vaked.dev/ultrawhale · /help ║
╚════════════════════════════════════════════════╝
🟢 LIVE · M1/arm64 · 150 blocks · $37.19 total cost vaked.dev/ultrawhale · event horizon · docs
---------|-----|--------| | Landing | vaked.dev/ultrawhale | ✅ LIVE | | Docs | vaked.dev/ultrawhale/docs | ✅ 50+ pages | | Book | vaked.dev/ultrawhale/book | ✅ mdBook | | Blog | vaked.dev/ultrawhale/blog | ✅ 2 posts | | HF Dataset | peterlodri-sec/ultrawhale-dogfood | ✅ 60 samples | | GitHub | peterlodri-sec/ultrawhale | ✅ |
[█░░░░░░░░░] v110 Reactive Capability Graph
[█░░░░░░░░░] v120 Self-Compiling (.vaked→native)
[█░░░░░░░░░] v130 Global Mesh (10+ machines)
[█░░░░░░░░░] v140 Quantum-Resistant
[█░░░░░░░░░] v150 Voice + AR Surfaces
[█░░░░░░░░░] v160 Formal Verification (Z3)
[█░░░░░░░░░] v170 Continuous Evolution
[█░░░░░░░░░] v180 Global Datasets (1000+ models)
[█░░░░░░░░░] v190 The Living Graph
[██████████] 🎯 v200 THE SINGULARITY
Reactive Capability Graph → Self-Compiling → Global Mesh → Quantum-Resistant → Voice+AR → Formal Verification → Continuous Evolution → Global Datasets → Living Graph → 🎯
Master Tracking Issue · Full Roadmap
This entire project (v1.0.0 → v100.1.0) cost $37.19 in DeepSeek API fees. That's $0.24 per release. $0.29 per block. $0.00 for 8 free models.
ultrawhale is a coding agent that builds itself. It's a research project, a philosophy, and a 121-block TUI application. You type. It thinks. Together you build things.
# One command to start
brew install ultrawhale
ultrawhale --model deepseek-v4-flash -w| Concept | Command | What it does |
|---|---|---|
| The Vaked Triangle | /vaked-pipeline |
Context × Time × Space |
| Fold = Gravity | /fold3d |
5D recursion visualization |
| SACRED surface | /sacred |
Inviolable form check |
| SPACE+TIME PROOF | /record-pov |
Cryptographic proof of recording |
| Surface entropy | /entropy |
Liveness detection (▓ 0.88) |
| I PROMISE PETER | /promise |
Mathematically provable LIVE |
# Homebrew
brew install peterlodri-sec/ultrawhale/ultrawhale
# Docker
docker pull ghcr.io/peterlodri-sec/ultrawhale:latest
# Go install
go install github.com/peterlodri-sec/ultrawhale/cmd/whale@latestSee docs/case-study-v10.md for the full case study of ultrawhale building its own v18.0.0 release via subagent swarms.
One prompt → swarm launch → real PRs → meta-report → v18.0.0 tagged.
ultrawhale has been audited for algorithmic complexity across all 59 blocks.
| Class | Count | Examples |
|---|---|---|
| O(1) | 28 | journal, log, hash, pov, self, current, sacred |
| O(n) | 12 | sed, diff, agent, swarm, orchestrator, ralph |
| O(n²) | 3 | dyad broadcast, sed worst-case, a2a mesh |
| O(V+E) | 1 | space (BFS Distance/Reachable) |
Full O(N)+O(T) Complexity Report — 59 blocks analyzed. Hot paths identified. Unbounded growth risks documented. 3 recommendations: AgentStore TTL, Ralph LRU, Sed Boyer-Moore.
Live dataset of human↔LLM interactions. 60 samples, 20 CS topics, PII-scrubbed. SSH-authenticated CI auto-publish. Dataset docs
ultrawhale runs a COUNCIL of language models:
| Council | Models | Cost |
|---|---|---|
| DeepSeek | V4 Flash, V4 Pro, Coder V3 | Paid |
| OpenRouter FREE | Gemma 3 4B, Mistral 7B, Llama 3.2 3B | $0 |
| GitHub Copilot | Via CI | Included |
All outputs stored in dedicated mem-brain. Multi-model verification. Dog Feed collects training data from free models.
Full Council Documentation · Disclaimer · Glossary
git clone https://github.com/peterlodri-sec/ultrawhale.git
cd ultrawhale
go build -trimpath -ldflags="-s -w" -o bin/ultrawhale ./cmd/whale
./bin/ultrawhale --model deepseek-v4-flash -wContent-addressed file primitives. Every write is sha256-verified, journaled for rollback, logged to ring buffer.
| Tier | Method | Speed |
|---|---|---|
| Go | crypto/sha256 (SHA-NI) |
1.5 GB/s |
| Assembly | AVX2+SHA-NI / ARMv8 NEON | ~8 GB/s |
| GPU | Metal / CUDA | ~40 GB/s |
| Plugin | Status |
|---|---|
| memory | ✅ Session memory |
| repomap | ✅ SIMD repo map (2,361 MB/s) |
| nats-eventbus | ✅ JetStream event streaming |
| langfuse-telemetry | ✅ Hierarchical LLM traces |
| superpowers | ✅ bao secrets auto-discovery |
| agentfield | ✅ Supabase-backed control plane |
/ultracode start — 7-phase autonomous coding: plan → implement → test → review → fix → verify → commit. All writes rollback-able.
Fixed-position ASCII dashboard in TUI. AgentField status, phase summary, uptime. Auto-dismisses on small terminals.
- Blocks Engine — API, hash tiers, asm kernels, sed
- AG-UI — Themes, ChatBlock, shader, keybindings
- Agent Loop — ultracode, POV, HUD, plugins
Brain + Memo system. /memo "fix the auth bug" stores scoped notes. /memo recall shows internal memos. Brain tracks 32-turn short-term
- jsonl long-term memory.
# Linux (amd64, GOAMD64=v3)
GOOS=linux GOARCH=amd64 GOAMD64=v3 go build -trimpath -ldflags="-s -w" -o bin/ultrawhale ./cmd/whale
# macOS (Apple Silicon)
GOOS=darwin GOARCH=arm64 go build -trimpath -ldflags="-s -w" -o bin/ultrawhale-darwin-arm64 ./cmd/whale
# With version injection
go build -ldflags="-X github.com/peterlodri-sec/ultrawhale/internal/build.Version=v18.0.0" ./cmd/whalePersistent workers with own AgentField and DID. Auto-detected for complex tasks (build, refactor, migrate). Subagents are disposable; swarms live between tasks and are reused when idle.
One-time confirmation on TUI start, then all tools auto-approved. Subagents: read_only (safe) or full_access (default). /orch status — view orchestrator state. Ctrl+Shift+O — toggle orchestrator sidepanel.
| Benchmark | Result | Notes |
|---|---|---|
| Hash 64KB (Go) | 1,464 MB/s | stdlib SHA-NI |
| Hash 64KB (Asm) | 1,524 MB/s | AVX2 assembly |
| Write 64KB | 596 MB/s | I/O bound |
| Batch-64 | 3.8ms | Atomic multi-file |
| Sed 1KB | 3,972ns / 257 MB/s | SIMD bytes.Index |
| SedFile | 7.25us | Journaled |
| Lifecycle | 547us | Write->Rollback->Read |
| Concurrent | 3,200 ops | 32 workers, 0 errors |
See docs/internal-blocks.md for the blocks engine architecture, performance patterns, benchmarks, and review checklist.
Build: GOOS=darwin GOARCH=arm64 go build ./cmd/whale (macOS) GOOS=linux GOARCH=amd64 GOAMD64=v3 go build ./cmd/whale (Linux) Test: go test -count=1 -race ./internal/... Bench: go test -bench=. -benchmem ./internal/blocks/
Apache 2.0 (upstream). Fork maintained by peterlodri-sec.