otoshek-local-setup

otoshek-local-setup

A Claude Code skill that sets up a complete local development environment for your Otoshek-deployed SaaS project.

Quick Start

Assumes Homebrew, mkcert, and Claude Code are already installed. If not, see Prerequisites below.

1. Open Claude Code in the folder where you want your project cloned

cd ~/Projects
claude

2. Add the Otoshek plugin marketplace

/plugin marketplace add otoshek/otoshek-local-setup

3. Install the skill

/plugin install otoshek-local-setup@otoshek-otoshek-local-setup

4. Relaunch Claude Code

claude

5. Run the setup

/otoshek-local-setup [email protected]:YOUR_USERNAME/YOUR_REPO.git

Claude will guide you through the rest.

What it does

After Otoshek deploys your SaaS app, you'll receive a GitHub repository. This skill automates cloning and configuring everything you need to start building locally:

• Verifies system prerequisites are installed (see below) and stops with install commands if any are missing
• Installs and configures PostgreSQL and VS Code (if not already installed)
• Configures HTTPS SSL certificates for local development (if not already set up)
• Creates and configures a local PostgreSQL database
• Sets up the Python virtual environment and installs dependencies
• Applies Django migrations and creates a superuser
• Configures environment variables (Google OAuth, Mailjet, Stripe)
• Syncs Stripe products and pricing from test mode
• Sets up VS Code with F5 launch for Django + React simultaneously (launch.json)

Supports macOS, Linux, and Windows. Auto-detects what is already installed and skips completed steps.

Prerequisites

The skill installs most tools automatically. Two steps require your password and must be done manually if not already set up: installing Homebrew and running mkcert -install (which registers a trusted local CA so browsers accept your dev certificates).

macOS / Linux

1. Check if Homebrew is already installed

command -v brew &>/dev/null && echo "Homebrew already installed"

2. Install Homebrew (skip if already installed)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Install mkcert

brew install mkcert && mkcert -install

Windows

Install the following tools manually (no Homebrew on Windows):

1. Git — accept default settings
2. Node.js — LTS version
3. Python 3.13 — enable "Add Python to PATH"
4. mkcert — download mkcert-*.exe, rename to mkcert.exe, add to PATH, then run:

   mkcert -install
   

Or install via Chocolatey:

choco install git nodejs python mkcert
mkcert -install

You'll also need

• A GitHub account with access to your Otoshek repository
• Your API credentials ready (Google OAuth, Mailjet, Stripe — provided during your Otoshek onboarding)

Installation

Step 1 — Install Claude Code (skip if already installed)

curl -fsSL https://claude.ai/install.sh | bash

Step 2 — Add the Otoshek plugin marketplace

Open a terminal in the folder where you want to clone your project and start Claude Code:

cd ~/Projects
claude

Then run:

/plugin marketplace add otoshek/otoshek-local-setup

Step 3 — Install the skill

/plugin install otoshek-local-setup@otoshek-otoshek-local-setup

Restart Claude Code — the skill is now available in every session.

Usage

Make sure Claude Code is open in the folder where you want to clone your project, then run:

/otoshek-local-setup [email protected]:YOUR_USERNAME/YOUR_REPO.git

You can also provide the HTTPS URL of your repository — the skill will convert it automatically:

/otoshek-local-setup https://github.com/YOUR_USERNAME/YOUR_REPO

Claude will guide you through the full setup, pausing only when human action is required.