Skip to content

Pre-Workshop Setup

Get your development environment ready before the workshop.

Setup Overview

Workshop setup has two phases: 1. Common Setup - Required for all participants 2. Environment Setup - Choose devcontainer or host machine path

Common Setup (Everyone)

Complete these steps first, regardless of which environment path you choose.

Clone Repository

git clone https://gitlab.com/cfi-pub/prompts2process
cd prompts2process

Choose Your Environment Path

Now select how you want to run the development environment:

Best for consistent, pre-configured environments with all tools installed.

Pros: - No host configuration needed - Consistent environment across all systems - Isolated from host system - All tools pre-installed

Cons: - Requires Docker Desktop - Larger initial download

Prerequisites: - Docker Desktop - Download from docker.com - VS Code with Dev Containers extension (or anysphere.remote-containers for Cursor)

Continue to Devcontainer Setup →

Host Machine

Install tools directly on your machine without Docker. There is an /install command you can use with your agent of choice to help walk you through the process.

Install Slash Command

Prerequisites: - Node.js 24+ - Via nvm or package manager - Bun Runtime 1.3.x - From bun.sh - Python 3.12+ - Via package manager - uv - From astral.sh/uv

Continue to Host Setup →

Quick Reference

After completing common setup above:

  1. Open VS Code in the repository root
  2. VS Code will prompt to "Reopen in Container" - click it
  3. Choose the all-agents profile

If the prompt doesn't appear, use Command Palette (Cmd/Ctrl+Shift+P) and select "Dev Containers: Reopen in Container".

The VS Code extension should handle port forwarding automatically.

Full devcontainer instructions →

Host Quick Start

After completing common setup above:

# Install tools (see host guide for details)
# Then install dependencies
uv sync && cd sandbox/raccoon-rocket-lab && bun install && cd ../..

# Start application
make web

Full host setup instructions →

Verification

After completing your chosen environment setup, verify everything works:

# Check Claude Code version
claude --version

# Start the sandbox application
make web

# Test in another terminal
curl http://localhost:35806

You should see the Raccoon Rocket Lab application running at http://localhost:35806.

Next Steps

Once your environment is set up:

  1. Review the workshop overview
  2. Explore the concepts and tools documentation