feat: add VS Code devcontainer support

.devcontainer/Dockerfile

@@ -0,0 +1,76 @@
+FROM python:3.12-bookworm
+
+# Install system dependencies and tools
+RUN apt-get update && apt-get install -y \
+    # Basic utilities
+    curl \
+    wget \
+    git \
+    sudo \
+    # Build essentials
+    build-essential \
+    # Zsh and utilities
+    zsh \
+    # Direnv
+    direnv \
+    # Clean up
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install GitHub CLI
+RUN curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg \
+    && chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg \
+    && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
+    && apt-get update \
+    && apt-get install -y gh \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create non-root user
+ARG USERNAME=vscode
+ARG USER_UID=1000
+ARG USER_GID=$USER_UID
+
+RUN groupadd --gid $USER_GID $USERNAME \
+    && useradd --uid $USER_UID --gid $USER_GID -m $USERNAME \
+    && echo $USERNAME ALL=\(root\) NOPASSWD:ALL > /etc/sudoers.d/$USERNAME \
+    && chmod 0440 /etc/sudoers.d/$USERNAME
+
+# Switch to non-root user for installations
+USER $USERNAME
+WORKDIR /home/$USERNAME
+
+# Install uv
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install Claude Code
+RUN curl -fsSL https://claude.ai/install.sh | bash
+
+# Configure zsh with Oh My Zsh
+RUN sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended
+
+# Configure direnv for zsh
+RUN echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc
+
+# Add uv and Claude Code to PATH in both bash and zsh
+RUN echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc \
+    && echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
+
+# Set zsh as default shell
+ENV SHELL=/usr/bin/zsh
+
+# Set working directory
+WORKDIR /workspace
+
+# Create .envrc file for direnv (will be populated later if needed)
+RUN touch /workspace/.envrc || true
+
+# Ensure proper permissions
+USER root
+RUN chown -R $USERNAME:$USERNAME /home/$USERNAME
+
+# Switch back to non-root user
+USER $USERNAME
+
+# Default command
+CMD ["/usr/bin/zsh"]

.devcontainer/devcontainer.json

@@ -0,0 +1,53 @@
+{
+  "name": "Bloomy Python SDK",
+  "dockerFile": "Dockerfile",
+  // Features to add to the dev container
+  "features": {
+    "ghcr.io/devcontainers/features/common-utils:2": {
+      "installZsh": true,
+      "configureZshAsDefaultShell": true,
+      "username": "vscode",
+      "userUid": "1000",
+      "userGid": "1000"
+    }
+  },
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
+  // Use 'postCreateCommand' to run commands after the container is created.
+  "postCreateCommand": "chmod +x /workspace/.devcontainer/post-create.sh && /workspace/.devcontainer/post-create.sh",
+  // Configure tool-specific properties.
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "charliermarsh.ruff",
+        "Anthropic.claude-code"
+      ],
+      "settings": {
+        "python.defaultInterpreterPath": "/workspace/.venv/bin/python",
+        "python.testing.pytestEnabled": true,
+        "python.testing.pytestPath": "uv run pytest",
+        "python.linting.enabled": false,
+        "python.formatting.provider": "none",
+        "[python]": {
+          "editor.formatOnSave": true,
+          "editor.codeActionsOnSave": {
+            "source.organizeImports": "explicit"
+          },
+          "editor.defaultFormatter": "charliermarsh.ruff"
+        },
+        "terminal.integrated.defaultProfile.linux": "zsh"
+      }
+    }
+  },
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  "remoteUser": "vscode",
+  // Mount the workspace
+  "workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=cached",
+  "workspaceFolder": "/workspace",
+  // Environment variables
+  "remoteEnv": {
+    "PATH": "/home/vscode/.local/bin:${containerEnv:PATH}"
+  }
+}

.devcontainer/post-create.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+set -e
+
+echo "🚀 Setting up Bloomy Python development environment..."
+
+# Ensure we're in the workspace directory
+cd /workspace
+
+# Install Python dependencies using uv
+echo "📦 Installing Python dependencies..."
+uv sync --all-extras
+
+# Set up direnv to auto-activate virtual environment
+echo "🔧 Setting up direnv for virtual environment activation..."
+if [ -f /workspace/.envrc ]; then
+    # Check if activation script is already in .envrc
+    if ! grep -q "source .venv/bin/activate" /workspace/.envrc; then
+        # Add virtual environment activation at the beginning of .envrc
+        echo '# Activate virtual environment
+if [ -f .venv/bin/activate ]; then
+    source .venv/bin/activate
+fi
+' | cat - /workspace/.envrc > /workspace/.envrc.tmp && mv /workspace/.envrc.tmp /workspace/.envrc
+        echo "✅ Added virtual environment activation to .envrc"
+    else
+        echo "✅ Virtual environment activation already configured in .envrc"
+    fi
+else
+    # Create .envrc with virtual environment activation
+    echo '# Activate virtual environment
+if [ -f .venv/bin/activate ]; then
+    source .venv/bin/activate
+fi
+' > /workspace/.envrc
+    echo "✅ Created .envrc with virtual environment activation"
+fi
+
+# Prompt for GitHub CLI authentication
+echo "🔐 GitHub CLI Authentication"
+echo "The GitHub CLI (gh) is installed for easy PR creation and repository management."
+echo ""
+echo -n "Would you like to authenticate with GitHub now? (y/N): "
+read -r response
+if [[ "$response" =~ ^[Yy]$ ]]; then
+    echo "🌐 Opening GitHub authentication in your browser..."
+    gh auth login --web
+else
+    echo "ℹ️  You can authenticate later by running: gh auth login --web"
+fi
+
+# Display success message
+echo "✅ Development environment setup complete!"
+echo ""
+echo "🔧 Available commands:"
+echo "  - pytest          # Run tests"
+echo "  - ruff check .    # Lint code"
+echo "  - ruff format .   # Format code"
+echo "  - pyright         # Type checking"
+echo "  - mkdocs serve    # Serve docs locally"
+echo "  - claude          # Use Claude Code for AI-assisted coding"
+echo "  - direnv allow    # Allow direnv to load .envrc"
+echo "  - gh pr create    # Create a pull request using GitHub CLI"
+echo ""
+
+echo "💡 Tips:"
+echo "  - The virtual environment will be auto-activated by direnv"
+echo "  - Claude Code is installed and available in your PATH"
+echo "  - You can configure your API key in .envrc"
+echo ""

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bloomy-python"
-version = "0.14.0"
+version = "0.15.0"
 description = "Python SDK for Bloom Growth API"
 readme = "README.md"
 authors = [{ name = "Franccesco Orozco", email = "franccesco@codingdose.info" }]