Skip to content
Otoshek
OTOSHEK · DOCS
SETUP · CLAUDE CODE SKILLscheduleRead · Auto · ~5 min

Automated Local Setup (Claude Code Skill)

Instead of manually configuring your entire development environment, you can use our official Claude Code skill: otoshek-local-setup. This skill completely automates downloading, configuring, and running your newly deployed project locally.

01

What it Automates

After Otoshek deploys your app, you'll receive a GitHub repository. Running the skill automates:

  • Prerequisite Validation: Verifies core system requirements are installed and stops with exact install commands if any are missing.
  • Software Setup: Installs and configures PostgreSQL and VS Code.
  • SSL Configuration: Configures HTTPS SSL certificates for local development.
  • Database Setup: Creates and configures your local PostgreSQL database.
  • Backend Environment: Sets up your Python virtual environment and installs dependencies.
  • Database Migrations: Applies Django migrations and creates a superuser.
  • Environment Files: Automatically fills in your .env file (Google OAuth, Mailjet, Stripe).
  • Stripe Sync: Connects and syncs Stripe products and pricing from test mode.
  • Editor Configuration: Sets up VS Code with F5 launch configurations to run both Django and React simultaneously.

The skill supports macOS, Linux, and Windows, automatically detecting what's already installed and gracefully skipping steps that are already completed.

02

Prerequisites

You must have the following system dependencies installed before running the skill. The skill will check for these on startup.

macOS

macOS prerequisites
# 1. Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. Required tools
brew install git node python@3.13 mkcert
mkcert -install

Linux

Linux prerequisites
# 1. Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. Required tools
sudo apt update && sudo apt install -y git nodejs npm
brew install python@3.13 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 then mkcert -install

You'll also need:

  • A GitHub account with access to your newly deployed Otoshek repository.
  • Your API credentials (Google OAuth, Mailjet, Stripe) prepared from the Otoshek setup wizard.
03

Installation

Follow these quick steps to install the required tools and the setup skill.

01Install Claude Code (skip if installed)

Download and install the Claude Code CLI tool via curl.

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

02Add the Otoshek Plugin Marketplace

Open your terminal and run Claude Code in any directory, then add the marketplace.

terminal
/plugin marketplace add otoshek/otoshek-local-setup

03Install the Skill

Install the official otoshek-local-setup skill to make it available in all future Claude sessions. (Requires Claude Code v1.0.33+)

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

Triggering the Setup

Open a terminal in the directory where you want your project to be cloned and initialized. Start Claude Code, and paste in the setup command alongside the repository link provided after your deployment.

terminal
/otoshek-local-setup git@github.com:YOUR_USERNAME/YOUR_REPO.git

When it will pause

While the skill is highly automated, it will pause and wait for your input in a few specific scenarios:

  • SSH Key Generation: If Claude doesn't detect working GitHub SSH keys, it will generate one, copy it to your clipboard, and pause. It will ask you to paste that key into your GitHub account settings and confirm before continuing.
  • Environment Variables: The skill will pause and ask you to paste your specific credentials into the chat so it can populate your local environment files. It will ask for your Google OAuth Client ID & Secret, Mailjet API Keys & Sender Email, Stripe Test Secret Key, and your Stripe Price IDs (6 values).
05

Running the App

The skill configures VS Code perfectly, but you still need to know how to actually launch the app once the skill finishes running.

  1. The skill should have already opened the project in VS Code automatically. If not, open the project folder in VS Code.
  2. Go to the Run and Debug sidebar (Ctrl+Shift+D or Cmd+Shift+D).
  3. Crucial Step: Select "Django + Frontend" from the debug dropdown menu at the top. (VS Code defaults to just the "Django_server" configuration).
  4. Press F5 to launch both servers simultaneously in integrated terminals.
  5. Open https://localhost:5173 in your browser (emphasize the https://).