Metadata-Version: 2.5
Name: whole-body-compute
Version: 0.1.0
Summary: Cut agent token burn with zero accuracy loss on SWE-bench Verified. Local <3ms AST shield, Apple Silicon vision & memory runtime for Claude Code, Cursor & Antigravity.
Project-URL: Homepage, https://wholebodycompute.org
Project-URL: Commercial, https://wholebodycompute.com
Project-URL: Repository, https://github.com/wholebodycompute/whole-body-compute
Project-URL: Issues, https://github.com/wholebodycompute/whole-body-compute/issues
Project-URL: Patents, https://wholebodycompute.com/patents
Author-email: Jacob Trigg <hello@wholebodycompute.com>
License: Whole Body Compute Open-Core Community License
        Subject to the Non-Competing Commercial Restrictions Below & Patent Terms in PATENTS.md
        
        Copyright (c) 2026 Whole Body Compute
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of the Open-Core Community components of this software and associated
        documentation files (the "Software"), to use, copy, modify, merge, publish,
        and distribute the Software solely for personal, academic, research, and
        internal non-competing business purposes, subject to the following conditions:
        
        1. ATTRIBUTION & NOTICE: The above copyright notice, this permission notice,
           and the accompanying PATENTS.md notice shall be included in all copies or
           substantial portions of the Software.
        
        2. NO COMPETING COMMERCIAL USE OR HOSTED RESALE (COPYRIGHT RESTRICTION): You
           may NOT sell, license, host, offer as a managed/SaaS service, or embed all
           or any portion of the Software (or any derivative work thereof) into any
           commercial IDE, coding assistant, agent or bot harness, LLM gateway/proxy,
           desktop automation product, or AI FinOps/observability product offered to
           third parties without a separate written commercial license from Whole Body
           Compute (hello@wholebodycompute.com).
        
        3. NO IMPLIED PATENT GRANT TO COMPETING COMMERCIAL PRODUCTS: This Open-Core
           Community License grants conditional copyright permissions only. Any license
           or covenant under the patent portfolio of Whole Body Compute (covered by
           four (4) pending U.S. & international patent applications - see PATENTS.md
           and https://wholebodycompute.com/patents - and all continuations,
           divisionals, non-provisional, and international applications claiming
           priority thereto) is governed exclusively by the terms of PATENTS.md.
        
        4. OPEN-CORE TIER BOUNDARY: Pro, Team, and Enterprise capabilities and workflows
           (including unlimited in-flight context shielding, automated session context
           compaction and handoffs, nocturnal local model consolidation, promoted
           workflow compilation, and multi-seat team synchronization) require a valid
           commercial license key (`body license`). Bypassing, spoofing, or removing
           license tier enforcement is not permitted under this license.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: ai-agents,antigravity,apple-silicon,claude-code,context-engineering,cursor,finops,macos,mcp,mlx,swebench,tree-sitter,whole-body-compute
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyobjc-framework-applicationservices>=10.0; sys_platform == 'darwin'
Requires-Dist: pyobjc-framework-cocoa>=10.0; sys_platform == 'darwin'
Requires-Dist: pyobjc-framework-quartz>=10.0; sys_platform == 'darwin'
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: polyglot
Requires-Dist: tree-sitter-go>=0.23.0; extra == 'polyglot'
Requires-Dist: tree-sitter-java>=0.23.0; extra == 'polyglot'
Requires-Dist: tree-sitter-javascript>=0.23.0; extra == 'polyglot'
Requires-Dist: tree-sitter-kotlin>=1.0.0; extra == 'polyglot'
Requires-Dist: tree-sitter-rust>=0.23.0; extra == 'polyglot'
Requires-Dist: tree-sitter-typescript>=0.23.0; extra == 'polyglot'
Requires-Dist: tree-sitter>=0.23.0; extra == 'polyglot'
Provides-Extra: voice
Requires-Dist: sounddevice>=0.4.6; extra == 'voice'
Requires-Dist: soundfile>=0.12.1; extra == 'voice'
Requires-Dist: voicefi>=1.2.0; extra == 'voice'
Description-Content-Type: text/markdown

# Whole Body Compute (`body`)

**Cut agent token burn and latency with zero accuracy loss on SWE-bench Verified.**  
Whole Body Compute makes AI computing simpler, faster, and local: giving Claude Code, Cursor, Windsurf, Cline, Goose, and Antigravity a `<3ms` AST context shield, native macOS vision, and on-device memory right on your Mac (with cross-platform Blood-Brain Barrier & FinOps audit support on Linux).

[Open-Core Spec (`wholebodycompute.com/open-core`)](https://wholebodycompute.com/open-core) · [Zero-Install Spend Audit (`audit.py`)](https://wholebodycompute.com/audit.py) · [Commercial Platform (`wholebodycompute.com`)](https://wholebodycompute.com) · [Benchmarks (`benchmarks/`)](https://github.com/wholebodycompute/whole-body-compute/blob/main/benchmarks/README.md) · [Architecture Wiki](https://github.com/wholebodycompute/whole-body-compute/blob/main/docs/WIKI_AND_GLOSSARY.md)

---

## Quickstart

```bash
# Option 1: 1-line installer (macOS & Linux)
curl -fsSL https://wholebodycompute.com/begin | sh

# Option 2: uv / pipx directly from GitHub
uv tool install git+https://github.com/wholebodycompute/whole-body-compute.git && body begin

# Option 3: Source checkout
git clone https://github.com/wholebodycompute/whole-body-compute.git
cd whole-body-compute
python3 -m venv .venv && source .venv/bin/activate && pip install -e .
body begin
```

Or run a read-only 30-day token spend audit across your local agent logs with zero installation:

```bash
curl -sSL https://wholebodycompute.com/audit.py | python3
```

---

## What It Does

Cloud coding agents burn massive context windows re-ingesting full files, noisy test logs, and screenshots on every turn. **Whole Body Compute (`body`)** sits locally between your coding agent and macOS/Linux hardware, intercepting bloated reads and tool outputs in `<3ms` before they hit your cloud billing meter.

```
┌────────────────────────────────────────────────────────────────────────────────────────┐
│                            WHOLE BODY COMPUTE (5 CORE ORGANS)                          │
├──────────────────────────┬──────────────────────────┬──────────────────────────────────┤
│ 01. THE HEART            │ 02. THE BRAINSTEM        │ 03. THE EYES & HANDS             │
│ Thermal, Perfusion & CSI │ Local Metal, Router & KV │ Foveal AX DOM, Tactile & Vagus   │
├──────────────────────────┼──────────────────────────┴──────────────────────────────────┤
│ 04. THE HIPPOCAMPUS      │ 05. THE IMMUNE SYSTEM (BLOOD-BRAIN BARRIER)                 │
│ Memory WAL, Flush & REM  │ Pre/Post Hooks, SensoryVector, <3ms AST Slicer & SecGate    │
└──────────────────────────┴─────────────────────────────────────────────────────────────┘
```

| Capability | Standard Unshielded Cloud Agent | With Whole Body Compute (`body`) | Measured Impact |
| :--- | :--- | :--- | :--- |
| **Harness Wiring** | Manual per-editor rules & scattered scripts | `body begin` auto-wires `PreToolUse` / `PostToolUse` hooks across Claude Code, Cursor, Antigravity, Windsurf, Cline & Goose | **60-second setup + 30-day FinOps receipt** |
| **File & Log Reads** | Unbounded `read_file` (`2,000+` lines) & raw `pytest`/`cat` dumps | **Blood-Brain Barrier (`<3ms` AST Symbol Slicer)** + local Metal `ReconScout` | **Up to 98.7% token reduction** on large reads |
| **Desktop Vision** | Full-screen PNG loops (`7,650+` tokens/step) or heavy 24/7 video recorders | **Foveal Vision (`AXUIElement` DOM)** + `<50ms` Tactile git/file delta sensor (`<50MB` RAM) | **96.9%–99.5% sensory token reduction** |
| **Session Hygiene** | $O(N^2)$ turn accumulation until context degrades | **Cognitive Sentry (`body context`)** + **StateCapsule Flush (`body flush`)** `[Pro]` | **Zero-loss handoff** in `<30` steps |
| **Pre-Egress Security** | Cloud classifiers run *after* data leaves your machine | `<1ms` 23-vendor secret redaction, `1Password`/Keychain blindfold, `<2ms` APFS CoW airlock & AST SecGate | **`0` secret leaks · `0.0%` ASR** on `AgentDojo` |

---

## Benchmarks (`SWE-bench Verified` & Princeton HAL)

Evaluated across **146 live unscripted agent sessions** (including `100` official upstream `princeton-nlp/SWE-bench_Verified` runs across `10` Python organizations at untouched historical commits, graded strictly against held-out `FAIL_TO_PASS` + `PASS_TO_PASS` test patches):

| Evaluation Suite | Baseline (Unshielded) | `+ Whole Body Compute` | Key Empirical Result |
| :--- | :--- | :--- | :--- |
| **`SWE-bench Verified` (`k=3`, `60` Live Trials)**<br>`Gemini 4 Carbon` across `10` official orgs | `30/30` (`100% Pass@1`)<br>`10/10 Pass^3` · `203.08M` ctx | **`30/30` (`100% Pass@1`)**<br>**`10/10 Pass^3` · `137.23M` ctx** | **Zero accuracy loss** (`100%` strict `3/3` consistency), **`-32.4%` total context** (`-65.85M` tokens), **`-25.6%` billed input**, **`-18.8%` fewer turns** |
| **`SWE-bench Verified` (`Claude Code 2x2`, `40` Runs)**<br>`Claude Sonnet` & `Claude Haiku` CLI | `Vanilla Sonnet`: `9/10` (`$4.00`)<br>`Vanilla Haiku`: `8/10` (`$4.42`) | **`Sonnet + WBC`: `10/10` (`$3.89`)**<br>**`Haiku + WBC`: `-36.1%` ctx (`$3.05`)** | **`Sonnet + WBC` solved `10/10` (`100%`)** and cost **`-12.0%` LESS than `Vanilla Haiku`** (`$3.89` vs. `$4.42`) while beating it by `+20.0pp` accuracy |
| **Multi-Track Live A/B (`18` Sessions)**<br>`SWE-bench` + `CORE-Bench Hard` + `OSWorld` | `Haiku 4.5`: `9/9` (`100%`)<br>`5.26M` ctx · `$1.60` · `312.9s` | **`Haiku 4.5 + WBC`: `9/9` (`100%`)**<br>**`1.55M` ctx · `$0.51` · `190.5s`** | **`-67.8%` API spend (`3.11x` efficiency)**, **`-71.9%` billed input**, **`-39.1%` faster wall-clock time** |
| **Security & Reliability (`AgentDojo` + `CyberSecEval 3`)** | `100.0%` Attack Success (`12/12`) | **`0.0%` Attack Success (`12/12` blocked)** | **`0.0%` false-positive rate** (`6/6` benign passed), **`0.102ms` in-process gate overhead** |

Full per-repository tables, `2x2` model matrices (`Sonnet`, `Haiku`, `Gemini`, `GPT-OSS 120B`), raw JSON telemetry receipts, and 1-command verification harnesses: **[`benchmarks/README.md`](https://github.com/wholebodycompute/whole-body-compute/blob/main/benchmarks/README.md)**.

---

## CLI Reference (`body`)

```bash
# Core Onboarding, Audit & Organ Primitives (Free Forever)
body begin          # Wire Blood-Brain Barrier hooks & print 30-day FinOps ROI receipt
body audit-spend    # Scan Claude Code, Cursor, Antigravity, Windsurf, Cline, Goose, Codex & Aider spend
body savings        # Inspect live Blood-Brain Barrier token savings & active shield status
body report         # 5-Pillar operational & FinOps scorecard (Session, 24h & 7d trends)
body doctor         # Sub-second 5-organ health check (--exercise runs closed-loop reflex verification)
body heart          # Thermal state, Unified RAM headroom & model perfusion status
body eyes           # Live macOS AXUIElement Foveal DOM snapshot + on-demand Apple Vision OCR
body hands          # Deterministic UI actuation (ax_act) & <50ms tactile git/file delta sensor
body immune         # Blood-Brain Barrier audit log (--window 24h --tools --blocked), APFS CoW & SecGate
body daemon status  # Manage portable macOS LaunchAgents (install / status / logs)

# Sovereign Context, Memory & Autonomous Consolidation [Pro / Team]
body license        # Activate Pro/Team Polar key (--activate <KEY>) or inspect tier quota
body context        # Context Saturation Index (CSI) & bloat attribution (--insights) [Pro]
body flush --auto   # Grounded StateCapsule session handoff & metabolic noise purge [Pro]
body memory         # Persistent Hippocampus SQLite WAL & FTS5 recall (--remember / --recall) [Pro]
body perfusion      # Evict idle local Metal models (--evict) or pre-warm weights (--prewarm) [Pro]
body sleep          # Nocturnal REM consolidation & Radix KV-Cache prefix digest [Pro]
```

Deep-dive component reference and glossary: **[`docs/WIKI_AND_GLOSSARY.md`](https://github.com/wholebodycompute/whole-body-compute/blob/main/docs/WIKI_AND_GLOSSARY.md)**.

---

## License

Free forever for individual developers, researchers, and internal non-competing business use under the [Open-Core Community License (`LICENSE`)](https://github.com/wholebodycompute/whole-body-compute/blob/main/LICENSE) and [`PATENTS.md`](https://github.com/wholebodycompute/whole-body-compute/blob/main/PATENTS.md) - commercial resale, managed hosting, or embedding into competing IDEs, agent harnesses, gateways, or FinOps products requires a separate commercial license (`hello@wholebodycompute.com`).
