dpm bubble

Spin up a temporary isolated environment with your DPM tools and dotfiles mounted in. Everything disappears when you exit the shell.

What is a bubble?

A bubble is an ephemeral session with a fresh HOME directory at /tmp/dpm-bubble-<id>/. Your installed DPM tools and dotfiles are available inside, but any files you create or changes you make are discarded when the session ends.

Bubbles are useful for:

Testing a tool without touching your real home directory.
Running a lab exercise in a clean, reproducible environment.
Sharing a session setup: same tools, same dotfiles, no leftover state.

CLI usage

        dpm bubble
        # short alias
        dpm -b
      

Running the command drops you into a new shell inside the bubble. The prompt will reflect the temporary HOME path. Exit the shell normally (exit or Ctrl+D) to end the session and discard all changes.

        dpm bubble
        bubble started, HOME=/tmp/dpm-bubble-a3f2/
        exit the shell to end the session
        exit
        bubble ended, all changes discarded
      

TUI: Bubble tab

Navigate to the Bubble tab with TAB. The screen shows the number of tools and dotfiles that will be available in the session, and the temporary HOME path format.

Press ENTER to start the bubble session.
The TUI suspends while the shell is active.
Exit the shell to return to the TUI.

Both CLI and TUI use the same backend (engine.bubble.start / engine.bubble.stop), behaviour is identical.

Cleanup

The temporary directory at /tmp/dpm-bubble-<id>/ is removed automatically when the session ends. No manual cleanup is needed.

Any files created inside the bubble are lost on exit. Do not use a bubble session as a working directory for files you want to keep.

← dpm verify

dpm dotfiles →