bootstrap-userspace

Detect host persistence surfaces and initialize the LDD trace store at session start.

2|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/veegee82/loss-driven-development --skill bootstrap-userspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bootstrap-userspace
Source: https://github.com/veegee82/loss-driven-development/tree/main/skills/bootstrap-userspace
Command: npx skills add https://github.com/veegee82/loss-driven-development --skill bootstrap-userspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

LDD requires a persistent trace store, but hosts differ in how they can write data. Bootstrap-userspace automatically detects the most durable persistence tier available, installs the LDD launcher, and ensures a trace is recoverable across restarts and host environments.

Core Features & Use Cases

  • Detects host persistence surfaces (filesystem, artifact/canvas, conversation-history, memory-pointer, inline-only) and silently selects the best available tier.
  • Restores prior trace state when a prior store exists and announces the chosen store in the trace header.
  • Installs and configures the ldd_trace launcher and trace hooks on session start for cross-host portability.
  • Works across Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, ChatGPT, and other hosts.
  • Use Case: You begin a new LDD task and Bootstrap-userspace ensures trace data is captured from the first step.

Quick Start

Invoke bootstrap-userspace at session start to detect the best trace storage and initialize the trace store.

Frequently Asked Questions about bootstrap-userspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist LDD trace data across different host environments?

To persist LDD trace data across host environments, you need an auto-detection mechanism that selects the highest-durability storage tier available, such as filesystem or artifact storage. Bootstrap-userspace automatically scans the host and initializes the correct trace store at session start.

What is an LDD trace store and when do I need to initialize it?

An LDD trace store is a persistent storage layer for capturing execution traces. You need to initialize it at session start if you want tracing data to remain recoverable across restarts and multiple host environments like Claude Code or Cursor.

How do I automatically restore prior trace state when starting a new session?

Automatically restoring prior trace state requires a launcher that detects existing persistence surfaces and reloads the previous data. Bootstrap-userspace handles this by scanning for an existing store and restoring the trace state during session initialization.

Does LDD tracing work with Claude Code, Codex, and Gemini CLI?

Yes, LDD tracing works with Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, and ChatGPT. Bootstrap-userspace ensures cross-host portability by installing the necessary trace hooks and selecting the best persistence tier for each specific environment.

What's the best way to select a persistence tier for trace storage?

Selecting a persistence tier for trace storage involves evaluating the host's available surfaces and choosing the most durable option. Bootstrap-userspace automates this evaluation, prioritizing filesystem, artifact/canvas, conversation history, memory pointer, or inline storage.

Why does my trace state disappear after restarting the host environment?

Trace state disappears after a restart if the persistence tier lacks durability or the launcher fails to restore prior data. Bootstrap-userspace resolves this by detecting the highest-durability storage available and automatically restoring the trace state at session start.