this-me 0.3.2

Rust ground for the modern .me semantic kernel.
Documentation
---
layout: readme
title: Rust .me CLI
image: https://neurons-me.github.io/docs/assets/img/me.png
---

# CLI

The `me` binary is a small local tool for exercising the Rust kernel.

Run without state for an ephemeral kernel:

```bash
cargo run -- write profile.name '"Jabellae"'
```

Run with a JSON snapshot file:

```bash
cargo run -- --state /tmp/me-state.json write profile.name '"Jabellae"'
cargo run -- --state /tmp/me-state.json read profile.name
cargo run -- --state /tmp/me-state.json snapshot
```

Execute canonical `me://` targets:

```bash
cargo run -- --state /tmp/me-state.json exec me://self:write/wallet.income 1000
cargo run -- --state /tmp/me-state.json exec me://self:read/wallet.income
cargo run -- --state /tmp/me-state.json exec me://kernel:read/events
```

Inspect and explain:

```bash
cargo run -- --state /tmp/me-state.json inspect profile
cargo run -- --state /tmp/me-state.json explain wallet.total
```

Produce a branch-scoped proof:

```bash
cargo run -- --who jabellae --secret 'correct horse battery staple' prove local.netget '{"nonce":"n-1"}'
```

Equivalent seed mode:

```bash
cargo run -- --seed '<seed>' --expression jabellae prove local.netget '{"nonce":"n-1"}'
```

The CLI is backed by `KernelRuntime`, so the command path exercises the same
load/execute/save lifecycle that embedders use.