Home - PauloCarv/drupalclaw-project GitHub Wiki

DrupalClaw Wiki

DrupalClaw is a self-hosted, agent-first Drupal development workspace. The agent understands your project structure, runs Drupal commands, manages your Docker stack, and can scaffold modules or import databases, all from a chat interface.

Using skills

Skills are the operations the agent knows how to run step by step. Invoke one by typing its name (drupal-cr) or with a slash (/drupal-cr), or just describe what you want and the agent picks the right skill. The chat autocomplete suggests skills as you type.

Guides

Guide What it covers
Providers and Login Choosing a provider, GitHub Copilot device login, /login
Learning and Expert mode Learn the commands as the agent runs them, or get concise results
Usage and Performance Tokens, cost, cache hit rate and the environmental estimate
Flows and Plans Automations, schedules and executable plans
Marketplace Browse and install skills from external catalogs
MCP servers Connect external tools and code intelligence
Updating Upgrading the image and how skills reach your workspace

Skills reference

Project and stack

Skill Description
drupal-init Initialize a project: new via Composer or clone from Git, with optional DB/files import
drupal-serve Start the Drupal dev stack (nginx + PHP-FPM + database)
drupal-stack Manage the Docker stack lifecycle (start, stop, restart, destroy)
drupal-status Full Drupal project status report
drupal-cr Rebuild Drupal caches
drupal-module Scaffold a new custom module with boilerplate structure
drupal-install Install a contrib module via Composer and enable it

Code quality

Skill Description
drupal-analyze Static analysis with PHPStan + PHPCS
drupal-fix Auto-fix coding standard issues with PHPCBF
drupal-index Index the codebase with GitNexus so the agent can query code relationships

Database

Skill Description
drupal-db-export Export the database to a SQL dump
drupal-db-import Import a SQL dump into the database
drupal-db-query Run a SQL query via Drush

Diagnostics

Skill Description
drupal-logs Show recent Drupal watchdog logs
drupal-debug Diagnose errors: watchdog, PHP errors, config issues
drupal-perf Analyse performance: caches, slow queries, bottlenecks

Plans

Skill Description
drupal-plan-run Execute a plan step by step, updating checkboxes as each step completes
drupal-plan-validate Run the verification checks of a plan and update its status

Extending

Skill Description
drupal-marketplace Install skills and MCP servers from a catalog URL

Internal

Skill Description
drupal-watchdog-cache Refreshes the log cache used by the interface; you normally never run it

Writing skills

Project links