Go from nothing to a running, AI-ready Drupal CMS site in one command. The One Line Installer bootstraps a fresh Drupal CMS site with DDEV, wires in AI best practices and a coding agent, and hands you a working site with the admin login already set up - on macOS, Linux, or Windows (WSL2), with all dependencies installed automatically.

Paste this into your terminal:

bash <(curl -fsSL https://aibp.drupalstarforge.ai/install.sh)

…and answer a few questions. Prefer to walk away and come back to a finished build? Add --yolo to accept sensible defaults for everything:

bash <(curl -fsSL https://aibp.drupalstarforge.ai/install.sh) --yolo

No Ruby, no PHP, no Composer, no manual DDEV setup required beforehand - the installer detects your OS and installs whatever is missing (Docker, DDEV, mkcert, and friends).


What the default installer does

Run with --yolo (or accept the defaults) and, with no further input, you get a complete, opinionated setup:

  • Detects your OS and installs any missing prerequisites - package-manager tooling, Docker, DDEV, and the mkcert local CA.
  • Creates a DDEV project and installs Drupal CMS via Composer into a clean web/ docroot.
  • Installs the AI tooling - the drupal/ai_best_practices module and its synchronized agent skills.
  • Sets up Claude Code as your in-container coding agent, ready to run with ddev claude.
  • Adds a starter skill set - Drupal Module Finder, Superpowers, Find new Skills, and Agent Browser - so the agent can search contrib, browse the site, and extend itself.
  • Teaches the agent to use your site - Agent Browser is installed by default, along with the knowledge of how to log in to the site and drive it like a real user.
  • Applies safe guardrails - a command denylist that stops the agent from running git push or ssh on your behalf.
  • Installs the site, exports its configuration, and launches it in your browser.

Log in with username admin / password admin - then start building.


What you can set up yourself

Run without --yolo and the installer front-loads every question up front, so you can tailor the build and then let it run unattended. You choose:

  • Site profile - Drupal CMS, Standard, Minimal, or a site template pulled straight from drupal.org.
  • Coding agent(s) - Claude Code, Codex, and/or OpenCode (baked into the container via the ddev-assistant add-ons), or bring your own host agent.
  • Agent skills - pick from a menu of Drupal-aware and general skills to install into your chosen agents.
  • Command denylist - pre-tick git push / ssh and add your own commands the agent must never run.
  • Selenium (functional testing) - add headed Chrome with a passwordless noVNC viewer so you can watch browser tests run.
  • Tool API + Toolbelt (experimental) - let agents drive Drupal actions and config through drush tool:* commands.
  • GitHub - create a repository and push your new site in one flow.

Two extra power features unlock once you install the tool globally (drupalaibp install, which adds a reusable drupalaibp command to your PATH):

  • Saved configs - capture your choices and a provisioning list (modules to require/enable, recipes to apply, extra add-ons and skills) into a named JSON config, then rebuild that exact stack unattended any time.
  • Management mode - re-run inside an existing DDEV project to add or remove the tooling this installer manages (AI best practices, coding agents, skills, add-ons, GitHub) through an interactive menu - no rebuild required.

For vibe coders & non-Drupal developers

You don't need to know Drupal to start building with it. One command gives you a real Drupal site and an AI coding agent that already knows how to work on it.

  • Zero setup knowledge required. You don't install Docker, DDEV, Composer, or Drupal by hand - the installer does all of it and checks its own work.
  • Familiar one-liner. Used to bootstrapping a whole project with a single npx create-... style command? This is that, for Drupal - one line spins up the site, the tooling, and your AI agent.
  • Just describe what you want. Open the agent (ddev claude) and ask for the feature, content type, or page you have in mind - it runs the Drupal commands for you.
  • It finds the right tools. With the Module Finder and Agent Browser skills, the agent searches Drupal's thousands of contributed modules before writing custom code, and can look at your live site to see what it's doing.
  • Built-in guardrails. The command denylist keeps the agent from doing anything risky (like pushing to git or opening SSH) without you.
  • A real site, instantly. Log in at your *.ddev.site URL with admin / admin and see your changes live.

Think of it as “Drupal with an expert pair-programmer built in.” You bring the ideas; the agent handles the Drupal.


For Drupal developers

A fast, reproducible local stack that respects how you already work - and layers agentic tooling on top without getting in the way.

  • Install it globally. Run drupalaibp install once to put a reusable drupalaibp command on your PATH - then start any new project with a single word instead of the curl one-liner.
  • Save templates for every project. Capture your preferred stack - profile, coding agents, skills, denylist, add-ons, plus a provisioning list (modules to require/enable, recipes to apply, extra add-ons and skills) - into a named config, then spin up that exact setup unattended for the next project, and the next.
  • Clean DDEV project. A single web/ docroot with the Composer root at the project dir, one build with zero restarts - all .ddev/ add-ons are staged before the first ddev start.
  • Test-ready out of the box. drupal/core-dev and phpunit.xml are wired in; opt into the Selenium add-on for headed, watchable functional tests over noVNC.
  • Choose your agent. Claude Code, Codex, or OpenCode as first-class DDEV add-ons (ddev claude / ddev codex / ddev opencode), or bring your own host agent - skills are shared via .agents/skills.
  • Managed AGENTS.md block. A marker-delimited section documents the site URL, how to run drush/composer through ddev, and which skills are active - regenerated on every run, your own notes left untouched.
  • Reconciling denylist. Per-agent guardrails (Claude settings.json, OpenCode, Codex rules) that merge - re-runs add and withdraw only the rules the installer owns, never clobbering yours.
  • Secret-ready. The agent is told to keep API keys out of code - store them as env vars with DDEV's built-in ddev dotenv set .ddev/.env, then wrap them in a Drupal Key entity via drush key:save (env provider) or reference them from settings.php with getenv(). Config is exported too, so your site is diffable from the start.
  • Experimental extras. Tool API + Toolbelt for agent-driven Drupal operations, plus config export baked into the flow.
  • Manage existing projects. Re-run inside any existing DDEV project to add or remove the tooling this installer manages through an interactive menu - no rebuild required.

Requirements

  • macOS (Intel or Apple Silicon) - internet connection only; every tool installs automatically.
  • Linux - Ubuntu/Debian or Fedora/RHEL/CentOS with sudo access and an internet connection.
  • Windows - WSL2 with an Ubuntu/Debian or Fedora/RHEL distribution; run from the WSL terminal.
Supporting organizations: 

Project information

  • Created by unqunq on , updated
  • shieldStable releases for this project are covered by the security advisory policy.
    There are currently no supported stable releases.

Releases