// reference

prismafs shell

shell mounts PrismaFS same like any mount, then starts interactive subshell within mountpoint. When you exit subshell, it shows session diff and prompts for keeping or discarding the session, and finally unmounts for you.

mkdir -p ~/pfs-base ~/pfs-session ~/pfs-mnt
echo hello > ~/pfs-base/hello.txt

export SESSION_LAYER_DIR=~/pfs-session
export BASE_LAYER_DIRS=~/pfs-base
prismafs shell ~/pfs-mnt

You are now in interactive shell (your $SHELL, or sh if unset) where working directory is ~/pfs-mnt. Like any mount, make some changes:

cat hello.txt
echo world > new.txt
exit

When exiting, PrismaFS unmounts and shows diff for this session (added, removed, modified), and prompts keep this session? [y/N]. Answering no removes session directory. Answering yes retains state on disk so you can inspect, export, or mount again later.