#moonix

WARNING: This library is highly experimental. APIs will change without notice. Do not use in production.

#What is this for?

1. AI sandbox: A safe execution environment for AI-generated code. All filesystem operations are isolated in memory — nothing touches the host system. Combined with capability-based security, this makes it suitable for running untrusted code from LLM outputs.

2. Git-backed virtual filesystem: Using @gitfs, you get a virtual filesystem with automatic git versioning powered by mizchi/bit. Every snapshot() creates a real git commit, and you can rollback(), branch(), and switch() — all in memory, no native git required.

┌─────────────────────────────────────────────┐
│  Your App / AI Agent                        │
├─────────────────────────────────────────────┤
│  @gitfs   - Git-versioned virtual FS        │
│  @fs      - Pluggable filesystem backend    │
│  @posix   - fd, env, cwd emulation          │
│  @proc    - Cooperative process scheduler   │
│  @net     - Virtual network / HTTP          │
│  @wasm    - WASM module execution           │
│  @capability - Permission control           │
├─────────────────────────────────────────────┤
│  MemFs (in-memory)                           │
└─────────────────────────────────────────────┘

#Installation

moon add mizchi/moonix

cd ~/ghq/github.com/mizchi/moonix
just install
moonix run dist/your.component.wasm --invoke 'run()'

#Example: Git-backed filesystem

// Create a git-versioned in-memory filesystem
let gfs = @gitfs.GitBackedFs::new(author="user <user@example.com>")

// Write files — just like a normal filesystem
gfs.write_file("/src/main.mbt", b"fn main { println(\"hello\") }")

// Snapshot creates a git commit internally
let snap = gfs.snapshot("initial commit")

// Modify and snapshot again
gfs.write_file("/src/main.mbt", b"fn main { println(\"world\") }")
let snap2 = gfs.snapshot("update message")

// Rollback to any previous snapshot
gfs.rollback(snap)

// Branch and switch
gfs.branch("feature")
gfs.switch("feature")

#Example: Virtual shell (currently disabled)

#Packages

#Related projects

• mizchi/bit — Pure MoonBit git implementation (used by @gitfs)
• mizchi/wasi — WASIp2 bindings for MoonBit
• mizchi/wasi_posix — WASI Preview2/Preview3 contract definitions for host injection boundaries

#License