sprites-shell

sprites-shell

Interactive shell over repos in a Mesa org running inside a Sprites sandbox, written in TypeScript.

Spins up a disposable Sprite, installs Mesa, mounts your org's repos via FUSE, and drops you into a minimal shell. Commands execute inside the sprite against the mounted filesystem.

Quick start

npm install

# Create a .env in this directory (gitignored)
cp .env.example .env

# Now populate your .env file with the required values

# Run
npm start

Starting sprite...
Mounting your-org...
Connected to ~/.local/share/mesa/mnt/your-org. Type "exit" or Ctrl+C to quit.

$ ls
repo-one  repo-two  repo-three
$ cd repo-one
$ ls
README.md  src/  package.json
$ exit
Cleaning up sprite...
Bye!

How it works

1. Creates a disposable Sprite via the Sprites SDK
2. Installs Mesa CLI and FUSE inside the sprite
3. Starts the FUSE daemon (mesa mount --daemonize) with your org and a short-lived access token
4. Drops you into a REPL rooted at the mounted org directory

Environment variables

Variable	Description
MESA_ORG	Your Mesa organization slug
MESA_PRIVATE_KEY	Mesa signing private key stored only in the trusted host process
SPRITES_TOKEN	Sprites token (get one here)

Requirements

• Node.js >= 18
• Mesa account with a signing key
• Sprites account with a token