Artisan Commands Reference

This reference covers commands shipped by the host packages in this repository: Core, Admin, and Frontend. Optional packages add their own commands; check their README or run php artisan list capell in the target app.

Install And Upgrade

capell:install

Runs the main install workflow. It can seed default data, run extension install workflows, configure a theme, create users, clear caches, generate sitemaps when a sitemap command is available, and install developer tooling.

php artisan capell:install
php artisan capell:install --demo --url=https://example.test [email protected]
php artisan capell:install --package-mode=custom --packages=capell-app/blog,capell-app/navigation

For a non-interactive local or CI install that runs every Composer-installed Capell package and installs AI / Agent Bridge developer tooling:

php artisan capell:install \
  --no-interaction \
  --url="${APP_URL}" \
  [email protected] \
  --all-packages \
  --developer-tooling

Use --no-boost-install when you only want Composer to install Laravel Boost and Capell Agent Bridge without regenerating local Boost guidelines, skills, or MCP files:

php artisan capell:install \
  --no-interaction \
  --url="${APP_URL}" \
  [email protected] \
  --all-packages \
  --developer-tooling \
  --no-boost-install

In non-interactive mode, always pass --url. If the app already has users, pass --user with an existing user ID or email. If the app has no users yet, pass --name, --email, and --password instead.

Option	Use it for
--demo	Seed demo content during install
--fresh	Clear existing Capell content before installing
--package-mode=core|all|custom	Choose how extension packages are selected
--packages=	Comma-separated package names for custom installs
--all-packages	Install all composer-installed Capell packages
--theme=	Activate a theme key when themes are available
--languages=	Comma-separated demo language codes
--sites=	Comma-separated demo site names
--no-seed-default-data	Skip default site, language, content type, and page setup
--url=	Site URL, defaulting to APP_URL
--user=	Existing user email or ID used as default author
--name= / --email= / --password=	First user details when the installer creates a user
--role-users	Create example users for common admin roles
--role-user-password=	Password for example role users
--no-side-effects	Show the install flow without running real side effects
--clear-cache	Clear caches without prompting
--generate-sitemap	Run sitemap generation when the command exists
--install-welcome-route	Remove the Laravel welcome home route when present
--developer-tooling	Install Laravel Boost and Capell Agent Bridge developer tooling
--no-boost-install	Install developer tooling packages without running boost:install

capell:upgrade

Runs the host upgrade flow: migration phase, registered upgrade steps, cache cleanup, and upgrade ledger checks.

php artisan capell:upgrade
php artisan capell:upgrade --dry-run
php artisan capell:upgrade --only-steps --force-step=2026_05_01_example

Option	Use it for
--dry-run	Show the plan without making changes
--force	Skip interactive confirmations
--force-downgrade	Continue when Composer reports an older version than the ledger
--no-clear-cache	Skip cache clearing after upgrade
--caches=	Comma-separated cache list: all, page, config, views
--skip-migrations	Skip migration publishing and running
--skip-steps	Skip registered upgrade steps
--only-migrations	Run only the migration phase
--only-steps	Run only registered upgrade steps
--force-step=*	Re-run a specific step ID

capell:rollback

Rolls back a recorded upgrade step.

php artisan capell:rollback --step=2026_05_01_example --dry-run
php artisan capell:rollback --step=2026_05_01_example --force

Use --dry-run before a real rollback. Use --force only when the impact is already understood.

Extension Lifecycle

capell:extension-install

Runs install workflows for extension packages that are already present in Composer.

php artisan capell:extension-install
php artisan capell:extension-install capell-app/blog --url=https://example.test --languages=en --sites=Main
php artisan capell:extension-install --all --dry-run

Option	Use it for
extension	Package name to install; omit to choose interactively
--all	Install every extension not already marked installed
--include-installed	Re-run install workflow for an installed extension
--dry-run	Show the install plan without running commands
--url=	Forward a site URL to packages that declare a URL install param
--languages=*	Forward language values to packages that declare language params
--sites=*	Forward site values to packages that declare site params
--user=	Forward a user value to packages that declare a user param
--assets=*	Forward asset values to packages that declare asset params
--param=*	Forward dynamic params as name=value, --name=value, or package-scoped values

capell:extension-audit

Validates a package directory, capell.json, or package directory collection against Capell extension contracts.

php artisan capell:extension-audit packages/example
php artisan capell:extension-audit packages/example/capell.json

capell:extension-playground

Inspects an extension package or manifest without installing it.

php artisan capell:extension-playground capell-app/blog --path=../packages-repository/packages

capell:make-extension

Scaffolds a local extension package and manifest.

php artisan capell:make-extension vendor/example --name="Example Extension" --path=packages
php artisan capell:make-extension vendor/pro-extension --premium

Developer Makers

capell:make

Lists or runs makers registered in MakerRegistry.

php artisan capell:make --dry-run
php artisan capell:make core.action --name=PublishPage --dry-run

Option	Use it for
maker	Registered maker key
--name=	Primary generated name
--type=	Optional type, schema, or component type
--source=	Optional source schema/component key
--livewire	Generate Livewire files when the maker supports it
--database	Allow database writes when the environment permits them
--dry-run	Preview without writing
--force	Overwrite existing files after warning

Legacy maker wrappers

These commands still exist for scripts and muscle memory:

php artisan capell:make-action CreatePage --data
php artisan capell:make-data PageAuthoringInput
php artisan capell:make-extender HeroFields AfterTitle
php artisan capell:make-schema LandingPage
php artisan capell:make-type LandingPage

Prefer capell:make for new docs and examples because it shows registered makers and supports dry runs.

Package Cache And Published Files

Package cache

php artisan capell:package-cache
php artisan capell:package-cache:clear

Use these after changing installed package metadata, manifests, or local Composer path repositories.

Components

php artisan capell:publish-components
php artisan capell:cache-components
php artisan capell:clear-components-cache

Publishing components is an override path. Prefer package extension points when you only need to add behaviour.

Migrations

php artisan capell:publish-migrations
php artisan capell:publish-migrations --type=settings
php artisan capell:publish-migrations --items=create_sites_table --path=database/migrations

Use package install commands for normal installs. Reach for direct migration publishing when building packages or debugging install flow.

Admin Commands

capell:admin-install

Installs Admin package requirements and can integrate Capell into a Filament panel.

php artisan capell:admin-install --admin-panel-changes=auto --panel=admin
php artisan capell:admin-install --admin-panel-changes=manual

capell:admin-setup

Runs admin setup and Filament panel integration.

php artisan capell:admin-setup --panel=admin --configurators=auto
php artisan capell:admin-setup --integration-only --preview

Common options:

• --url=, --user=, --languages=, --sites=, and --theme= seed initial admin context.
• --integration-only edits the panel without running the wider setup.
• --skip-panel-integration leaves the Filament panel untouched.
• --configurators=auto discovers configurators automatically.
• --no-colors, --no-widgets, and --no-navigation skip those panel changes.
• --skip-permission-sync skips the permission sync that normally follows admin install.
• --preview shows proposed file changes without writing.
• --force skips confirmation prompts.

See Admin setup for the panel integration flow.

Admin cache and publishing

php artisan capell:admin-clear-cache
php artisan capell:admin-cache-widgets
php artisan capell:admin-clear-widgets-cache
php artisan capell:admin-cache-configurators
php artisan capell:admin-clear-configurators-cache
php artisan capell:admin-publish-resources --type=page --force

capell:admin-publish-resources is an advanced escape hatch. Most package work should use resources, extenders, configurators, bridges, and settings schemas instead of publishing host resources.

Admin upgrades

php artisan capell:admin-upgrade
php artisan capell:admin-upgrade-summary-email

Upgrade summary email recipients come from CAPELL_UPDATE_NOTIFICATION_EMAILS.

Frontend Commands

php artisan capell:frontend-install
php artisan capell:frontend-install --dev
php artisan capell:frontend-after-install
php artisan capell:frontend-after-install --dev
php artisan capell:frontend-upgrade

--dev runs the Vite development build path instead of the production build where supported.

Demo Helpers

php artisan capell:faker --count=25 --packages --sites=Main --languages=en --force
php artisan capell:core-faker --count=10 --sites=Main --languages=en

These create local content for development and testing. Do not run them against production data.

Optional-Package Commands

Commands such as static-site generation, sitemap generation, package-specific demo commands, and frontend Tailwind aggregation are provided by optional packages in a consuming app. Keep those commands in the package README or package docs that own them.

Command	Package
capell:static-site	capell-app/html-cache
capell:xml-sitemap	capell-app/site-discovery
capell:frontend-tailwind-assets	capell-app/foundation-theme
capell:admin-demo	capell-app/demo-kit
capell:demo-kit-full-demo	capell-app/demo-kit

The source of truth in any app is:

php artisan list capell

Further Reading

• Install guide
• Configuration reference
• Admin setup
• Creating Capell packages
• Approved packages