diff --git a/AGENTS.md b/AGENTS.md
index 6720d2449..71c97f447 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -8,14 +8,16 @@ This repo contains multiple packages, but **`packages/coding-agent/`** is the pr
 
 ### Package Structure
 
-| Package                 | Description                                          |
-| ----------------------- | ---------------------------------------------------- |
-| `packages/ai`           | Multi-provider LLM client with streaming support     |
-| `packages/agent`        | Agent runtime with tool calling and state management |
-| `packages/coding-agent` | Main CLI application (primary focus)                 |
-| `packages/tui`          | Terminal UI library with differential rendering      |
-| `packages/stats`        | Local observability dashboard (`omp stats`)          |
-| `packages/pi-utils`     | Shared utilities (logger, streams, temp files)       |
+| Package                 | Description                                           |
+| ----------------------- | ----------------------------------------------------- |
+| `packages/ai`           | Multi-provider LLM client with streaming support      |
+| `packages/agent`        | Agent runtime with tool calling and state management  |
+| `packages/coding-agent` | Main CLI application (primary focus)                  |
+| `packages/tui`          | Terminal UI library with differential rendering       |
+| `packages/natives`      | WASM bindings for native text/image/grep operations   |
+| `packages/stats`        | Local observability dashboard (`omp stats`)           |
+| `packages/pi-utils`     | Shared utilities (logger, streams, temp files)        |
+| `crates/pi-natives`     | Rust WASM crate for performance-critical text/grep ops |
 
 ## Code Quality
 
@@ -426,12 +428,25 @@ Logs go to `~/.omp/logs/omp.YYYY-MM-DD.log` with automatic rotation.
 
 ## Commands
 
-- After code changes: `bun run check` (runs biome + tsc, get full output, no tail)
-- For auto-fixable lint issues: `bun run fix` (includes unsafe fixes)
+| Command        | Description                                      |
+| -------------- | ------------------------------------------------ |
+| `bun check`    | Check all (TypeScript + Rust)                    |
+| `bun check:ts` | Biome check + tsgo type checking                 |
+| `bun check:rs` | Cargo fmt --check + clippy                       |
+| `bun lint`     | Lint all                                         |
+| `bun lint:ts`  | Biome lint                                       |
+| `bun lint:rs`  | Cargo clippy                                     |
+| `bun fmt`      | Format all                                       |
+| `bun fmt:ts`   | Biome format                                     |
+| `bun fmt:rs`   | Cargo fmt                                        |
+| `bun fix`      | Fix all (unsafe fixes + format)                  |
+| `bun fix:ts`   | Biome --unsafe + format-prompts                  |
+| `bun fix:rs`   | Clippy --fix + cargo fmt                         |
+
 - NEVER run: `bun run dev`, `bun test` unless user instructs
 - Only run specific tests if user instructs: `bun test test/specific.test.ts`
 - NEVER commit unless user asks
-- Do NOT use `tsc` or `npx tsc` - always use `bun run check`
+- Do NOT use `tsc` or `npx tsc` - always use `bun check`
 
 ## GitHub Issues
 
diff --git a/README.md b/README.md
index b07345aa7..143281056 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,7 @@
   <a href="https://github.com/can1357/oh-my-pi/actions"><img src="https://img.shields.io/github/actions/workflow/status/can1357/oh-my-pi/ci.yml?style=flat&colorA=222222&colorB=3FB950" alt="CI"></a>
   <a href="https://github.com/can1357/oh-my-pi/blob/main/LICENSE"><img src="https://img.shields.io/github/license/can1357/oh-my-pi?style=flat&colorA=222222&colorB=58A6FF" alt="License"></a>
   <a href="https://www.typescriptlang.org"><img src="https://img.shields.io/badge/TypeScript-3178C6?style=flat&colorA=222222&logo=typescript&logoColor=white" alt="TypeScript"></a>
+  <a href="https://www.rust-lang.org"><img src="https://img.shields.io/badge/Rust-DEA584?style=flat&colorA=222222&logo=rust&logoColor=white" alt="Rust"></a>
   <a href="https://bun.sh"><img src="https://img.shields.io/badge/runtime-Bun-f472b6?style=flat&colorA=222222" alt="Bun"></a>
   <a href="https://discord.gg/4NMW9cdXZa"><img src="https://img.shields.io/badge/Discord-5865F2?style=flat&colorA=222222&logo=discord&logoColor=white" alt="Discord"></a>
 </p>
@@ -346,7 +347,14 @@ Handles whitespace and indentation variance automatically:
 | **[@oh-my-pi/pi-agent-core](packages/agent)**          | Agent runtime with tool calling and state management                          |
 | **[@oh-my-pi/pi-coding-agent](packages/coding-agent)** | Interactive coding agent CLI                                                  |
 | **[@oh-my-pi/pi-tui](packages/tui)**                   | Terminal UI library with differential rendering                               |
-| **[@oh-my-pi/omp-stats](packages/stats)**          | Local observability dashboard for AI usage statistics                         |
+| **[@oh-my-pi/pi-natives](packages/natives)**           | WASM bindings for native text, image, and grep operations                     |
+| **[@oh-my-pi/omp-stats](packages/stats)**              | Local observability dashboard for AI usage statistics                         |
+
+### Rust Crates
+
+| Crate                              | Description                                              |
+| ---------------------------------- | -------------------------------------------------------- |
+| **[pi-natives](crates/pi-natives)** | Rust WASM crate for performance-critical text/grep ops   |
 
 ---