skills.rest
gobifrost
gobifrostOFFICIAL
Explore all skills by this author →
GitHub

bifrost-debug

Deploy isolated per-worktree Bifrost development stacks with hot reload.

55|14|Updated Oct 12, 2025
Search Tags:#ui testing#docker compose#local development#hot reload#bifrost#debug stack#per-worktree
One-click install
npx skills add https://github.com/gobifrost/bifrost --skill bifrost-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bifrost-debug
Source: https://github.com/gobifrost/bifrost/tree/main/.claude/skills/bifrost-debug
Command: npx skills add https://github.com/gobifrost/bifrost --skill bifrost-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual effort of setting up and managing isolated Bifrost development stacks, letting you test UI features, capture screenshots, and verify code changes without spending time on environment configuration or dealing with conflicting running stacks across multiple worktrees.

Core Features & Use Cases

  • Per-Worktree Isolation: Run multiple Bifrost dev stacks in parallel across different worktrees without port conflicts or data overlap.
  • Auto-Detected Access Modes: Automatically uses Netbird mesh access or local port exposure based on your environment's configuration.
  • Hot Reload Support: Code changes to the API, scheduler, worker, and client take effect instantly without manual container restarts.
  • Auto CLI Integration: Automatically connects the Bifrost CLI to the running debug stack and stores authentication tokens securely in your system keychain.
  • Use Case: When building a new Bifrost UI feature, spin up your isolated dev stack, test the feature in your browser, capture screenshots for stakeholder reviews, and tear it down when done without affecting other running environments.

Quick Start

Request the AI to launch the Bifrost debug stack for your current worktree, and it will start the isolated hot-reload environment, provide you with the accessible browser URL, and confirm the local Bifrost CLI is connected for immediate testing.

Frequently Asked Questions about bifrost-debug

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

FAQPage Schema
How do I run isolated Docker Compose dev stacks for UI testing without port conflicts?▼

Hot reload is supported for API, scheduler, worker, and client code changes, meaning your modifications take effect instantly without manual container restarts. The Skill applies code updates automatically across the containerized stack components.

Does the Bifrost debug stack work with Netbird mesh for local development access?▼

The Skill automatically connects the Bifrost CLI to the running debug stack and stores authentication tokens securely in your system keychain. This eliminates manual CLI configuration when you launch the environment.

What is the best way to capture screenshots for documentation in an isolated development stack?▼

Yes, you can run multiple Bifrost dev stacks in parallel across different worktrees without data overlap. The per-worktree isolation ensures each environment remains independent for parallel development workflows.

How do I access logs for debugging containerized stack components during local development?▼

The Skill provides integrated log access for debugging containerized stack components while your isolated dev stack is running. You can monitor API, scheduler, worker, and client logs to troubleshoot issues during UI testing.

Related Skills

Explore More Software Engineering Skills→
silva2kandsilva2kand

docker-compose-ops

Manage, configure, and debug Docker Compose multi-container environments.

Community
Intermediate
rahul-s-bhattrahul-s-bhatt

debugging-streamlit

Run Streamlit debug sessions to inspect logs and validate UI behavior.

Community
Advanced
gustavscirulisgustavscirulis
114

auth-flow

Generate authentication infrastructure with Sign in with Apple, biometrics, and Keychain storage.

Community
Advanced
yongwoonyongwoon
8

ywc-docker-isolate

Derive deterministic Docker port blocks and project names per Git worktree.

Community
Advanced