ai-tools

Focused repo for two components only:

• rlm — Recursive Language Model extension for pi
• safe-pi — macOS disposable NixOS VM wrapper for running pi

Quick setup

1) Link the rlm extension into ~/.pi

make install

2) Install safe-pi into ~/.local/bin

make install-safe-pi

If ~/.local/bin is not in your PATH, add it in your shell profile.

safe-pi (macOS)

safe-pi runs pi inside a disposable NixOS VM via Lima.

Prerequisite

brew install lima

Usage

safe-pi --help
safe-pi "your prompt"
safe-pi --model gpt-5

By default, safe-pi prepends --new-session unless you pass an explicit session/resume flag.

Runtime behavior inside VM:

• Host project dir is mounted read/write at /workspace
• Host ~/.pi is mounted read/write at /home/agent/.pi
• shell starts in /workspace
• run checks for /workspace/flake.nix:
  • if present: nix develop /workspace --command pi ...
  • otherwise: run pi directly from /workspace

For direct VM lifecycle control:

./scripts/safe-pi-vm.sh up
./scripts/safe-pi-vm.sh shell
./scripts/safe-pi-vm.sh stop
./scripts/safe-pi-vm.sh destroy
./scripts/safe-pi-vm.sh status

To reset to a fresh disposable VM, run destroy and then up (or just run safe-pi again).

Repo layout

• packages/rlm — RLM extension source
• extensions/rlm — extension entry (symlink to packages/rlm)
• scripts/safe-pi — host wrapper command
• scripts/safe-pi-vm.sh — VM lifecycle/runner script
• strategies/program_idea_to_impl.md — default strategy seed used by RLM

Packages

Package	Description
packages/rlm	Recursive Language Model state management for structured coding tasks