Run

Pull latest code from a branch and launch the Foundry GUI.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/beekeeper-lab/foundry --skill run-beekeeper-lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Run
Source: https://github.com/beekeeper-lab/foundry/tree/main/.claude/skills/run
Command: npx skills add https://github.com/beekeeper-lab/foundry --skill run-beekeeper-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates updating a local Foundry development environment by pulling the latest code from a specified branch and launching the GUI.

Core Features & Use Cases

  • Branch-aware updates: fetches, checks out main or test, preserving work while updating dependencies.
  • Deterministic launch: synchronizes dependencies and launches the Foundry GUI to ensure a consistent environment.
  • Safe workflow management: auto-stashes dirty worktrees and restores them after the app exits.

Quick Start

Run this skill to pull the latest code from main or test and launch the Foundry desktop app.

Frequently Asked Questions about Run

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

FAQPage Schema
How do I pull the latest code and launch Foundry locally from a remote branch?

To pull the latest code and launch Foundry locally, this skill automates fetching the specified branch, checking out main or test, synchronizing dependencies, and launching the GUI before restoring your previous state.

What happens to uncommitted changes when updating my local Foundry development environment?

When updating your local Foundry development environment, the skill safely auto-stashes dirty worktrees before pulling and checking out branches, then restores your uncommitted changes after the application exits.

Do I need uv and git to run an automated Foundry branch update?

Yes, you need both git and uv installed, along with access to the main or test branches, to run an automated Foundry branch update and synchronize dependencies successfully.

Can I synchronize dependencies and launch the Foundry GUI on a specific branch?

Yes, you can synchronize dependencies and launch the Foundry GUI deterministically on either the main or test branch, ensuring a consistent environment by coordinating fetch, checkout, and pull operations.

Why does my local Foundry launch use stashed work instead of the freshly pulled code?

Your local Foundry launch restores stashed work after the app exits to preserve your in-progress changes, meaning the freshly pulled code runs first and your dirty worktree is reapplied safely afterward.

What is the best way to manage remote Foundry workflows where development happens on a server?

The best way to manage remote Foundry workflows is automating the local update cycle: fetch server-side changes, checkout target branches, sync dependencies, launch locally, and restore state automatically.