### Conductor Setup Script Example

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

TOML configuration for setting up Conductor workspace hooks using dust-hive adopt, start, and unregister commands.

```toml
[scripts]
setup = "dust-hive adopt --path \"$CONDUCTOR_WORKSPACE_PATH\" --name \"$CONDUCTOR_WORKSPACE_NAME\""
run = "dust-hive start \"$CONDUCTOR_WORKSPACE_NAME\""
archive = "dust-hive unregister \"$CONDUCTOR_WORKSPACE_NAME\""
run_mode = "concurrent"
```

--------------------------------

### Setup Existing Conductor Workspace

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/docs/conductor.md

For existing Conductor workspaces created before the setup script was added, run this command sequence from within the workspace. This adopts the workspace and starts the environment.

```bash
workspace="$(git rev-parse --show-toplevel)"
env_name="$(basename "$workspace")"
"$DUST_REPO/.husky/post-checkout"
dust-hive adopt --path "$workspace" --name "$env_name" --base-branch main
dust-hive start "$env_name"
direnv allow
```

--------------------------------

### Install Dependencies

Source: https://github.com/dust-tt/dust/blob/main/connectors/README.md

Run this command to install all necessary project dependencies.

```bash
npm install
```

--------------------------------

### Start Temporal Worker (Slack Example)

Source: https://github.com/dust-tt/dust/blob/main/connectors/README.md

Use this command to start a Temporal worker, for example, for Slack integration.

```bash
npm run slack-worker
```

--------------------------------

### Dust Hive Quick Start Commands

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

A set of commands for quickly setting up and managing environments. Includes starting services, spawning new environments, warming them up, opening their terminals, getting app URLs, and shutting everything down.

```bash
# Start managed services (temporal + test postgres + test redis + main session)
dust-hive up

# Create a new environment
dust-hive spawn myenv

# Start all services for one or more environments (docker, front, core, connectors, etc.)
dust-hive warm myenv

# Open the environment's terminal UI
dust-hive open myenv

# Get the app URL
dust-hive url myenv
# http://localhost:10000

# Open in browser
open $(dust-hive url myenv)

# Stop everything when done
dust-hive down
```

--------------------------------

### Start API Server

Source: https://github.com/dust-tt/dust/blob/main/connectors/README.md

Execute this command to start the API server for the connectors.

```bash
npm run start-api
```

--------------------------------

### Development Environment Setup

Source: https://github.com/dust-tt/dust/blob/main/cli/dust-cli/README.md

Instructions for setting up the development environment for the Dust CLI, including Node.js version management, dependency installation, and building the CLI.

```bash
npm install
npm run build
# or
npm run build:dev
# or
npm run dev
```

```bash
node dist/index.js <command>
```

--------------------------------

### Install and Import Sparkle Components

Source: https://github.com/dust-tt/dust/blob/main/sparkle/src/stories/Introduction.mdx

Install the Sparkle package and import components from the package root. This example shows how to import Button and Input components and use the Button component.

```tsx
import { Button, Input } from "@dust-tt/sparkle";

export function Example() {
  return <Button variant="highlight" label="Get started" />;
}
```

--------------------------------

### Install Project Dependencies and Build

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-evals/README.md

Install project dependencies using Bun and then build the project.

```bash
bun install
bun run build
```

--------------------------------

### Install and Verify Bun Runtime

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-evals/README.md

Install the Bun runtime using the provided script and verify the installation by checking the version.

```bash
curl -fsSL https://bun.sh/install | bash
bun --version
```

--------------------------------

### Install Dust SDK

Source: https://github.com/dust-tt/dust/blob/main/sdks/js/README.md

Install the Dust client library using npm.

```javascript
npm install @dust-tt/client
```

--------------------------------

### Adopt and Start Conductor Workspace

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/docs/conductor.md

When adopting a workspace that previously had Conductor setup scripts, use these commands instead of `dust-hive warm`.

```bash
dust-hive adopt ...
```

```bash
dust-hive start ...
```

--------------------------------

### Run Dust iOS App (Build, Launch, Install)

Source: https://github.com/dust-tt/dust/blob/main/x/adrsimon/mobile/README.md

Builds the app, boots the simulator, installs the app, and launches it.

```bash
make run
```

--------------------------------

### Sidebar Wiring Example

Source: https://github.com/dust-tt/dust/blob/main/x/spolu/credit_pricing/billing/overview.md

Example demonstrating how to wire navigation sidebar elements.

```typescript
front/components/navigation/config.ts:240-291
```

--------------------------------

### Install Rust Toolchain

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install the Rust toolchain using the official installer script.

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

--------------------------------

### Install Dependencies with Bun

Source: https://github.com/dust-tt/dust/blob/main/x/henry/mp-sandbox-agent/README.md

Run this command to install project dependencies using Bun.

```bash
bun install
```

--------------------------------

### Install OrbStack (Docker)

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install OrbStack, a Docker alternative, using Homebrew.

```bash
brew install --cask orbstack
```

--------------------------------

### Install DustHive and Link

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/docs/conductor.md

Navigate to the DustHive directory within your Dust checkout, install its dependencies using bun, and then link it globally. This prepares DustHive for use.

```bash
cd "$DUST_REPO/x/henry/dust-hive"
bun install
bun link
dust-hive doctor
```

--------------------------------

### Install Zellij

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install Zellij, a terminal multiplexer, using Homebrew.

```bash
brew install zellij
```

--------------------------------

### Install DustHiveCat CLI

Source: https://github.com/dust-tt/dust/blob/main/x/daph/dust-hive-cat/README.md

Builds the app, installs it to /Applications/, sets up the notify script, and adds the dustcat CLI to your PATH. Run this command from the project's root directory.

```bash
cd x/daph/dust-hive-cat
./Scripts/cli.sh install
```

--------------------------------

### Install Dependencies with Homebrew

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/docs/conductor.md

Installs `jq` and `sqlite` using Homebrew. These are required by the `conductor-name` script.

```bash
brew install jq sqlite
```

--------------------------------

### Install Bun

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install Bun, the runtime for dust-hive, using the provided curl command.

```bash
curl -fsSL https://bun.sh/install | bash
```

--------------------------------

### Install Temporal CLI

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install the Temporal CLI, a workflow engine, using Homebrew.

```bash
brew install temporal
```

--------------------------------

### Install psql

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install psql, a PostgreSQL client required for the seed-config command, using Homebrew.

```bash
brew install postgresql
```

--------------------------------

### Install fzf (Optional)

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install fzf, an optional fuzzy finder used by `dust-hive open` when a name is omitted, using Homebrew.

```bash
brew install fzf
```

--------------------------------

### Install direnv

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install direnv, a tool for automatically loading environment variables, using Homebrew.

```bash
brew install direnv
```

--------------------------------

### Install Build Dependencies

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install necessary build dependencies including cmake and protobuf using Homebrew.

```bash
brew install cmake protobuf
```

--------------------------------

### Install sccache (Optional)

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install sccache, an optional Rust compilation cache to speed up rebuilds, using Homebrew.

```bash
brew install sccache
```

--------------------------------

### Install Dependencies and Build Project

Source: https://github.com/dust-tt/dust/blob/main/firebase-functions/webhook-router/README.md

Standard npm commands to install project dependencies and build the TypeScript code.

```bash
npm install
```

```bash
npm run build
```

--------------------------------

### Install nvm

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Install nvm (Node Version Manager) for managing Node.js versions, required for front/connectors.

```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
```

--------------------------------

### Install Dust CLI Globally

Source: https://github.com/dust-tt/dust/blob/main/cli/dust-cli/README.md

Installs the Dust CLI globally on your system using npm.

```bash
npm install -g @dust-tt/dust-cli
```

--------------------------------

### Headless Authentication Examples

Source: https://github.com/dust-tt/dust/blob/main/cli/dust-cli/README.md

Demonstrates how to use headless authentication with environment variables or command-line arguments for various Dust CLI commands, including chat and skill initialization.

```bash
# Set environment variables once
export DUST_API_KEY="sk_your_api_key_here"
export DUST_WORKSPACE_ID="ws_abc123"

# Chat with headless auth
dust chat

# Install the dust skill
dust skill:init

# Use with specific agent
dust chat --sId 1234567890
```

```bash
# Chat with headless auth
dust chat --wId ws_abc123 --api-key sk_your_api_key_here

# Install the dust skill with headless auth
dust skill:init --wId ws_abc123 --api-key sk_your_api_key_here

# Use with specific agent
dust chat --sId 1234567890 --wId ws_abc123 --api-key sk_your_api_key_here
```

--------------------------------

### Install Firebase CLI

Source: https://github.com/dust-tt/dust/blob/main/firebase-functions/slack-webhook-router/README.md

Install the Firebase Command Line Interface globally using npm.

```bash
npm install -g firebase-tools
```

--------------------------------

### Start Managed Services

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Starts the Temporal server and the main zellij session. The '-a' flag attaches to the zellij session immediately. This command also runs 'dust-hive sync' to update dependencies.

```bash
# From the main Dust repo (on main branch, clean working directory)
dust-hive up

# Or attach to the main zellij session immediately
dust-hive up -a
```

--------------------------------

### Example Route File Structure

Source: https://github.com/dust-tt/dust/blob/main/front-api/CODING_RULES.md

Illustrates the mapping of URL paths to file locations within the front-api/routes directory, including dynamic segments.

```tree
front-api/routes/
  healthz.ts                                       # /api/healthz
  w/
    [wId]/
      index.ts                                     # mounts children, applies workspaceAuth
      models.ts                                    # /api/w/:wId/models
      providers/
        index.ts                                   # /api/w/:wId/providers
      spaces/
        index.ts                                   # /api/w/:wId/spaces — GET /, POST /
        [spaceId]/
          index.ts                                 # mounts /:spaceId children
          leave.ts                                 # /api/w/:wId/spaces/:spaceId/leave
          mcp/
            available.ts                           # /api/w/:wId/spaces/:spaceId/mcp/available
          ...
  v1/
    w/
      [wId]/
        index.ts                                   # applies publicApiAuth
        spaces.ts
```

--------------------------------

### Install Dependencies and Link Globally

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Installs project dependencies and links the dust-hive package globally using Bun. This makes the 'dust-hive' command available system-wide. No build step is required as Bun handles TypeScript directly.

```bash
cd x/henry/dust-hive
bun install
bun link
```

--------------------------------

### Install and Enable Direnv for Zsh

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/docs/conductor.md

Install the direnv utility using Homebrew and enable its integration with the zsh shell by adding the necessary eval command to your .zshrc file.

```bash
brew install direnv
grep -q 'direnv hook zsh' ~/.zshrc || echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc
```

--------------------------------

### Test Locally with Firebase Emulator

Source: https://github.com/dust-tt/dust/blob/main/firebase-functions/slack-webhook-router/README.md

Start the Firebase emulator to test your functions and hosting locally.

```bash
npm run dev
```

--------------------------------

### Spawn Environment Session with Warm-up

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Use this command to open a zellij session for a specific environment and start the warm-up process. This is useful for preparing services while you work.

```bash
dust-hive spawn myenv --warm
```

--------------------------------

### Check dust-hive prerequisites

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Run this command to diagnose and check the prerequisites for dust-hive services to start correctly.

```bash
dust-hive doctor
```

--------------------------------

### Build User Target

Source: https://github.com/dust-tt/dust/blob/main/front/CODING_RULES.md

Example of constructing a target object for a user.

```typescript
{ type: "user", id: user.sId, name: user.fullName() }
```

--------------------------------

### Working on a Feature with Dust Hive

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Use these commands to create, start, open, and stop a development environment for a new feature.

```bash
# Create environment
dust-hive spawn my-feature

# Start everything
dust-hive warm my-feature

# Open terminal
dust-hive open my-feature

# ... work on your feature ...

# When done for the day
dust-hive stop my-feature
```

--------------------------------

### Install Git Post-Checkout Hook

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/docs/conductor.md

Installs a local `post-checkout` Git hook to ensure skills are present in new worktrees immediately after `git worktree add` completes. This script synchronizes skills and configuration from the main checkout to the new worktree.

```bash
cd "$DUST_REPO"
mkdir -p .husky
grep -qxF '.husky/' .git/info/exclude || echo '.husky/' >> .git/info/exclude

cat > .husky/post-checkout <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

worktree="$(git rev-parse --show-toplevel 2>/dev/null || true)"
common_git_dir="$(git rev-parse --git-common-dir 2>/dev/null || true)"

if [ -z "$worktree" ] || [ -z "$common_git_dir" ]; then
  exit 0
fi

case "$common_git_dir" in
  /*) ;; 
  *) common_git_dir="$(cd "$worktree" && cd "$common_git_dir" && pwd -P)" ;; 
esac

main_checkout="${common_git_dir%/.git}"

if [ "$worktree" = "$main_checkout" ]; then
  exit 0
fi

if [ ! -d "$main_checkout/.claude/skills" ]; then
  exit 0
fi

mkdir -p "$worktree/.claude"
rm -rf "$worktree/.claude/skills"
cp -R "$main_checkout/.claude/skills" "$worktree/.claude/skills"

if [ -f "$main_checkout/.claude/config.toml" ]; then
  cp "$main_checkout/.claude/config.toml" "$worktree/.claude/config.toml"
fi

rm -rf "$worktree/.codex"
ln -s .claude "$worktree/.codex"
EOF

chmod +x .husky/post-checkout
git config core.hooksPath "$DUST_REPO/.husky"
```

--------------------------------

### Conductor Local Settings TOML Configuration

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/docs/conductor.md

Defines Conductor scripts for setup, run, and archive, along with run mode settings. The setup script handles DustHive environment initialization or adoption.

```toml
"$schema" = "https://conductor.build/schemas/settings.repo.schema.json"

spotlight_testing = false

[scripts]
setup = '''
set -euo pipefail

if HIVE_PATH="$(dust-hive cd "$CONDUCTOR_WORKSPACE_NAME" 2>/dev/null)"; then
  if [ "$HIVE_PATH" != "$CONDUCTOR_WORKSPACE_PATH" ]; then
    echo "DustHive env '$CONDUCTOR_WORKSPACE_NAME' already exists at $HIVE_PATH, expected $CONDUCTOR_WORKSPACE_PATH" >&2
    exit 1
  fi

  dust-hive start "$CONDUCTOR_WORKSPACE_NAME"
else
  dust-hive adopt \
    --path "$CONDUCTOR_WORKSPACE_PATH" \
    --name "$CONDUCTOR_WORKSPACE_NAME" \
    --base-branch "$CONDUCTOR_DEFAULT_BRANCH"
fi
'''

run = '''
dust-hive start "$CONDUCTOR_WORKSPACE_NAME"
'''

archive = '''
dust-hive unregister "$CONDUCTOR_WORKSPACE_NAME" || true
'''

run_mode = "concurrent"

```

--------------------------------

### Deploy to Production

Source: https://github.com/dust-tt/dust/blob/main/firebase-functions/webhook-router/README.md

Build and deploy the Firebase Functions and Hosting configurations to production. This script automates validation, environment setup, and deployment steps.

```bash
npm run deploy   # Builds and deploys to Firebase Functions + Hosting
```

--------------------------------

### Hard-coded Substitution Example

Source: https://github.com/dust-tt/dust/blob/main/design_docs/SECRET_SWAP_DESIGN.md

Demonstrates the basic placeholder and its successful replacement. Both strings are 31 bytes to avoid HTTP framing issues.

```text
__DUST_EXPERIMENT_PLACEHOLDER__   →   __SUCCESSFULLY_REPLACED________
```

--------------------------------

### Running Multiple Environments Simultaneously

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Commands to create, warm, and list multiple dust-hive environments, along with examples of accessing them via URLs.

```bash
# Create and warm two environments
dust-hive spawn env-a --warm
dust-hive spawn env-b --warm

# Both running simultaneously
dust-hive list
# env-a    warm    http://localhost:10000
# env-b    warm    http://localhost:11000

# Access both
open http://localhost:10000  # env-a
open http://localhost:11000  # env-b
```

--------------------------------

### Execute Sidekick Seed Script

Source: https://github.com/dust-tt/dust/blob/main/front/scripts/seed/sidekick/README.md

Run this command to execute the sidekick seed script. Ensure you have Node.js and npm/npx installed.

```bash
npx tsx scripts/seed/sidekick/seed.ts --execute
```

--------------------------------

### Install dsbx-issued CA into System Store

Source: https://github.com/dust-tt/dust/blob/main/design_docs/SECRET_SWAP_DESIGN.md

Copies the egress CA certificate and updates the system's trusted CA certificates. This should be done at boot.

```bash
cp /run/dust/egress-ca.pem /usr/local/share/ca-certificates/dust-egress.crt
update-ca-certificates
```

--------------------------------

### Get all agents

Source: https://github.com/dust-tt/dust/blob/main/sdks/js/README.md

Retrieve a list of all agent configurations. You can then filter them, for example, to get only active agents.

```javascript
const r = await dustAPI.getAgentConfigurations();

if (r.isErr()) {
  throw new Error(`API Error: ${r.error.message}`);
} else {
  const agents = r.value.filter((agent) => agent.status === "active");
}
```

--------------------------------

### DustCat CLI Commands

Source: https://github.com/dust-tt/dust/blob/main/x/daph/dust-hive-cat/README.md

Available commands for managing the DustHiveCat application after installation. These commands handle setup, updates, and application lifecycle.

```bash
dustcat install     # First-time setup
dustcat update      # Rebuild from source, replace app, restart
dustcat start       # Launch the app
dustcat stop        # Quit the app
dustcat uninstall   # Remove everything
```

--------------------------------

### Run Eval in Background

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-evals/claude.md

Start an evaluation process in the background to get an immediate shell ID for monitoring. This is the initial step for long-running evaluations.

```bash
run_in_background: true
```

--------------------------------

### Create Conductor Settings File

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/docs/conductor.md

Creates a local Conductor configuration directory and opens the settings file for editing.

```bash
cd "$DUST_REPO"
mkdir -p .conductor
$EDITOR .conductor/settings.local.toml
```

--------------------------------

### Create Configuration Directory and Copy Environment File

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Creates the necessary directory for the configuration file and copies a template environment file. The 'config.env' file must use 'export' statements for all environment variables.

```bash
mkdir -p ~/.dust-hive
cp /path/to/your/.env ~/.dust-hive/config.env
```

--------------------------------

### Start Environment Without Auto-Forwarding

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

When starting an environment with the 'warm' command, you can prevent automatic port forwarding by using the --no-forward flag.

```bash
dust-hive warm myenv --no-forward

```

--------------------------------

### Deploy to Production

Source: https://github.com/dust-tt/dust/blob/main/firebase-functions/slack-webhook-router/README.md

Build and deploy the Firebase Functions and Hosting configuration to production.

```bash
npm run deploy
```

--------------------------------

### Install npm dependencies in dust-hive worktree

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Before running `npm install` in a dust-hive worktree, remove the existing `node_modules` directory due to dust-hive's symlink-based structure.

```bash
rm -rf node_modules && npm install
```

--------------------------------

### Run Tests with Bun

Source: https://github.com/dust-tt/dust/blob/main/x/henry/mp-sandbox-agent/README.md

Execute this command to run the project's tests.

```bash
bun test
```

--------------------------------

### Install the `conductor-name` CLI Helper

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/docs/conductor.md

Creates a directory for local binaries, downloads the `conductor-name` script, and makes it executable. This script is used to rename Git branches and update Conductor metadata.

```bash
mkdir -p ~/.local/bin
cat > ~/.local/bin/conductor-name <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
export PATH="/opt/homebrew/bin:/usr/local/bin:$HOME/.local/bin:/usr/bin:/bin:/usr/sbin:/sbin"

usage() {
  cat <<'USAGE'
Usage:
  conductor-name [--dry-run] <name>

Examples:
  conductor-name fix-workspace-env
  conductor-name "external worktree docs"
  conductor-name username/external-worktree-docs

Optional:
  export CONDUCTOR_BRANCH_PREFIX=username
USAGE
}

dry_run=0
if [[ "${1:-}" == "--dry-run" ]]; then
  dry_run=1
  shift
fi

if [[ $# -eq 0 || "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
  usage
  exit 0
fi

for bin in git jq sqlite3 sed mktemp; do
  if ! command -v "$bin" >/dev/null 2>&1; then
    echo "Missing required command: $bin" >&2
    exit 1
  fi
done

label="$*"
branch_prefix="${CONDUCTOR_BRANCH_PREFIX:-}"

slugify() {
  printf '%s' "$1" \
    | tr '[:upper:]' '[:lower:]' \
    | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//; s/-+/-/g'
}

if [[ "$label" == */* && "$label" != *" "* ]]; then
  branch="$label"
  display_name="${label##*/}"
else
  display_name="$label"
  slug="$(slugify "$display_name")"
  if [[ -z "$slug" ]]; then
    echo "Could not derive a branch slug from: $display_name" >&2
    exit 1
  fi

  if [[ -n "$branch_prefix" ]]; then
    branch="$branch_prefix/$slug"
  else
    branch="$slug"
  fi
fi

workspace_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"
if [[ -z "$workspace_root" ]]; then
  echo "Not inside a git worktree." >&2
  exit 1
fi

hive_env="$(basename "$workspace_root")"
metadata="$HOME/.dust-hive/envs/$hive_env/metadata.json"
if [[ ! -f "$metadata" ]]; then
  echo "Could not find DustHive metadata for env '$hive_env'." >&2
  echo "Expected: $metadata" >&2
  exit 1
fi

current_branch="$(git -C "$workspace_root" branch --show-current)"
if [[ -z "$current_branch" ]]; then
  echo "Could not determine current branch in: $workspace_root" >&2
  exit 1
fi

if [[ "$current_branch" != "$branch" ]] && git -C "$workspace_root" show-ref --verify --quiet "refs/heads/$branch"; then
  echo "Branch already exists: $branch" >&2
  exit 1
fi

echo "Workspace: $workspace_root"
echo "Hive env:   $hive_env"
echo "Branch:     $current_branch -> $branch"
echo "Label:      $display_name"

if [[ "$dry_run" -eq 1 ]]; then
  exit 0
fi

tmp="$(mktemp)"
trap 'rm -f "$tmp"' EXIT
jq --arg branch "$branch" '.workspaceBranch = $branch' "$metadata" > "$tmp"

if [[ "$current_branch" != "$branch" ]]; then
  git -C "$workspace_root" branch -m "$branch"
fi

db="$HOME/Library/Application Support/com.conductor.app/conductor.db"

sql_quote() {
  printf "'%s'" "$(printf '%s' "$1" | sed "s/'/''/g")"
}

if [[ -f "$db" ]]; then
  root_sql="$(sql_quote "$workspace_root")"
  branch_sql="$(sql_quote "$branch")"
  label_sql="$(sql_quote "$display_name")"
  if updated_rows="$(sqlite3 "$db" "
    update workspaces
       set branch = $branch_sql,
           placeholder_branch_name = $branch_sql,
           workspace_name = $label_sql,
           user_set_workspace_name = 1,
           user_set_branch_name = 1,
           updated_at = datetime('now')
     where workspace_path = $root_sql;
    select changes();
  " 2>/dev/null)"; then
    if [[ "$updated_rows" == "0" ]]; then
      echo "Warning: Conductor database did not contain this workspace path." >&2
    fi
  else
    echo "Warning: could not update Conductor display metadata." >&2
  fi
fi

mv "$tmp" "$metadata"
trap - EXIT

echo "Done. If Conductor does not refresh immediately, switch workspaces or restart the app."
EOF
chmod +x ~/.local/bin/conductor-name
```

--------------------------------

### Manage Node Modules in Dust Hive Worktree

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/CLAUDE.md

When working with a dust-hive worktree, you must remove the existing node_modules directory before running npm install to ensure correct package installation.

```bash
rm -rf node_modules && npm install
```

--------------------------------

### Run SwiftFormat for Formatting

Source: https://github.com/dust-tt/dust/blob/main/x/adrsimon/mobile/README.md

Runs SwiftFormat to apply code formatting rules and writes changes to files.

```bash
make format
```

--------------------------------

### Build Dust iOS App for Release Environment

Source: https://github.com/dust-tt/dust/blob/main/x/adrsimon/mobile/README.md

Builds the app with the release environment configuration.

```bash
make build:release
```

--------------------------------

### Build API Key Target

Source: https://github.com/dust-tt/dust/blob/main/front/CODING_RULES.md

Example of constructing a target object for an API key.

```typescript
{ type: "api_key", id: key.sId }
```

--------------------------------

### Configure OpenAI API Key

Source: https://github.com/dust-tt/dust/blob/main/x/henry/mp-sandbox-agent/README.md

Create a .env file in the root directory and add your OpenAI API key.

```dotenv
OPENAI_API_KEY=your_api_key_here
```

--------------------------------

### Seat and Plan Information

Source: https://github.com/dust-tt/dust/blob/main/x/spolu/credit_pricing/billing/overview.md

Endpoints to get details about seat plans, counts, and availability.

```APIDOC
## GET /api/w/[wId]/seats/plan

### Description
Retrieves the current seat plan details, including available AWU credits, price, and currency.

### Method
GET

### Endpoint
/api/w/[wId]/seats/plan

### Parameters
#### Path Parameters
- **wId** (string) - Required - The workspace ID.

### Response
#### Success Response (200)
- **plan** (string) - The name of the plan (e.g., 'pro', 'max').
- **awuCredits** (integer) - The number of available AWU credits.
- **priceCents** (integer) - The price in cents.
- **currency** (string) - The currency of the price.

```

```APIDOC
## GET /api/w/[wId]/seats/count

### Description
Retrieves the counts of seats broken down by seat type.

### Method
GET

### Endpoint
/api/w/[wId]/seats/count

### Parameters
#### Path Parameters
- **wId** (string) - Required - The workspace ID.

### Response
#### Success Response (200)
- **seatCounts** (object) - An object containing counts for different seat types.

```

```APIDOC
## GET /api/w/[wId]/seats/availability

### Description
Provides information on seat availability and invite affordances. Note: This is not intended for the new Billing page; credit pricing is moving to a model without unassigned/available seats.

### Method
GET

### Endpoint
/api/w/[wId]/seats/availability

### Parameters
#### Path Parameters
- **wId** (string) - Required - The workspace ID.

### Response
#### Success Response (200)
- **availableSeats** (integer) - The number of available seats.
- **maxSeats** (integer) - The maximum number of seats allowed.

```

--------------------------------

### Build Dust iOS App for Simulator

Source: https://github.com/dust-tt/dust/blob/main/x/adrsimon/mobile/README.md

Builds the app for the simulator, with the environment selecting the configuration.

```bash
make build
```

--------------------------------

### Metronome Contract API Endpoints

Source: https://github.com/dust-tt/dust/blob/main/x/spolu/credit_pricing/billing/overview.md

API endpoints for GET and PATCH operations on Metronome contracts.

```typescript
front/pages/api/w/[wId]/metronome/contract.ts
```

--------------------------------

### Test Locally with Firebase Emulator

Source: https://github.com/dust-tt/dust/blob/main/firebase-functions/webhook-router/README.md

Start the Firebase emulator to test the webhook router and config sync functions locally. This command launches emulators for Functions, Hosting, Realtime Database, and Storage.

```bash
npm run dev      # Start Firebase emulator
```

--------------------------------

### Build Dust Sandbox CLI

Source: https://github.com/dust-tt/dust/blob/main/cli/dust-sandbox/README.md

Instructions for building the dust-sandbox CLI using Cargo. After building, you can run the executable with the --help flag to see available options.

```sh
cd cli/dust-sandbox
cargo build
./target/debug/dsbx --help
```

--------------------------------

### Get All Active Agents

Source: https://github.com/dust-tt/dust/blob/main/sdks/js/README.md

Fetch all agent configurations and filter for active agents. Handles potential API errors.

```javascript
const r = await dustApi.getAgentConfigurations();

if (r.isErr()) {
  throw new Error(`API Error: ${r.error.message}`);
} else {
  const agents = r.value.filter((agent) => agent.status === "active");
}
```

--------------------------------

### Deploy Cloudflare Worker

Source: https://github.com/dust-tt/dust/blob/main/preview-proxy/README.md

Install dependencies and deploy the Cloudflare Worker using Wrangler. Ensure you have logged in to Wrangler beforehand.

```bash
npm install
npx wrangler login   # one-time
npx wrangler deploy
```

--------------------------------

### Execute Triggers Seed Script

Source: https://github.com/dust-tt/dust/blob/main/front/scripts/seed/triggers/README.md

Run the script to seed webhook sources and triggers. Ensure you have the necessary prerequisites installed.

```bash
npx tsx scripts/seed/triggers/seed.ts --execute
```

--------------------------------

### Headless Authentication with Command-line Arguments

Source: https://github.com/dust-tt/dust/blob/main/cli/dust-cli/README.md

Provides an alternative method for headless authentication by passing workspace ID and API key directly as command-line arguments. Command-line flags take precedence over environment variables.

```bash
dust [command] --workspaceId <workspace-id> --key <your-api-key>
```

--------------------------------

### Adopting an Externally Managed Worktree

Source: https://github.com/dust-tt/dust/blob/main/x/henry/dust-hive/README.md

Commands to adopt an external worktree into dust-hive management, including registration, starting, and unregistering.

```bash
dust-hive adopt --path "$WORKSPACE_PATH" --name "$WORKSPACE_NAME"
dust-hive start "$WORKSPACE_NAME"
dust-hive unregister "$WORKSPACE_NAME"
```