PHPackages                             sitegeist/magicwand - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. sitegeist/magicwand

ActiveNeos-package[CLI &amp; Console](/categories/cli)

sitegeist/magicwand
===================

Tools that make the Flow/Neos development easier

v4.5.2(5mo ago)46190.6k—6.6%15[8 issues](https://github.com/sitegeist/Sitegeist.MagicWand/issues)[2 PRs](https://github.com/sitegeist/Sitegeist.MagicWand/pulls)3MITPHP

Since Mar 1Pushed 5mo ago6 watchersCompare

[ Source](https://github.com/sitegeist/Sitegeist.MagicWand)[ Packagist](https://packagist.org/packages/sitegeist/magicwand)[ RSS](/packages/sitegeist-magicwand/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (54)Used By (3)

Sitegeist.MagicWand
===================

[](#sitegeistmagicwand)

### Tools that make the Flow/Neos development easier

[](#tools-that-make-the-flowneos-development-easier)

This package is intended to be used on development systems and should **NEVER** be installed on production servers. **Please add this package to the require-dev section of your composer.json**.

### Authors &amp; Sponsors

[](#authors--sponsors)

- Wilhelm Behncke -
- Martin Ficzel -
- ... and others

*The development and the public-releases of this package is generously sponsored by our employer .*

Easy and fast cloning of Flow and Neos Installations
----------------------------------------------------

[](#easy-and-fast-cloning-of-flow-and-neos-installations)

The CLI commands `clone:list`, `clone:preset` to help to clone a remote Flow/Neos setup into the local Flow/Neos installation that executes the command.

**Attention: These commands will empty the local database and resources of your local Flow installation. The data is replaced with the information from the remote host. Make sure you understand that before actually using the commands.**

### CLI-Examples

[](#cli-examples)

```
# show all available presets
./flow clone:list

# clone from remote host with the information stored in the master preset
./flow clone:preset master

```

### Settings.yaml

[](#settingsyaml)

The presets that are defined in the configuration path. `Sitegeist.MagicWand.clonePresets`

```
Sitegeist:
  MagicWand:
    flowCommand: './flow'

    # preset which is used by the clone:default command
    defaultPreset: 'master'

    # available presets
    clonePresets:

       # the name of the preset for referencing on the clone:preset command
      master:
        # hostname or ip of the server to clone from
        host: ~
        # ssh username
        user: ~
        # ssh port
        port: ~
        # ssh options
        sshOptions: ~
        # path on the remote server
        path: ~
        # flow-context on the remote server
        context: Production

        # the flow cli command on the remote server
        # default is the main flowCommand-Setting
        flowCommand: ~

        # options to adjust the clone process
        clone: []

        # commands to execute after cloning like ./flow user:create ...
        postClone: []

        # informations to access the resources of the cloned setup via http
        # if this is configured the rsync of the persistent resources is skipped
        # and instead resources are fetched and imported on the fly once read
        resourceProxy:
          baseUri: http://vour.server.tld
          # define an optional subDirectory (defaults to: '_Resources/Persistent/', trailing slash is required!)
          subDirectory: '_Resources/Persistent/'
          # define wether or not the remote uses subdivideHashPathSegments
          subdivideHashPathSegment: false
          # curl options
          curlOptions:
            CURLOPT_USERPWD: very:secure
```

The settings should be added to the global `Settings.yaml` of the project, so that every developer with SSH-access to the remote server can easily clone the setup.

Quick backup and restore mechanisms for persistent data
-------------------------------------------------------

[](#quick-backup-and-restore-mechanisms-for-persistent-data)

Sometimes it's useful to quickly backup an integral persistent state of an application, to then perform some risky change operations and restore the data in case of failure. The `stash:create`,`stash:restore`,`stash:list` and `stash:clear` commands of this package allow for a flawless backup-try-restore workflow.

**Attention: These commands will empty the database and resources of your local Flow installation. The data is replaced with the information from the stash. Make sure you understand that before actually using the commands.**

### CLI-Examples

[](#cli-examples-1)

```
# Create a backup of the entire database and the directory `Data/Persistent` ("stash entry") under the given name
./flow stash:create --name=name

# Lists all named stash entries
./flow stash:list

# Restores a stash entry
./flow stash:restore --name=name

# Removes all stash entries
./flow stash:clear

```

**Note:** Use this command on a regular basis, because your stash tends to grow **very** large.

Resource proxies
----------------

[](#resource-proxies)

While cloning the database to your local dev system is manageable even for larger projects, downloading all the assets is often not an option.

For this case the package offers the concept of resource proxies. Once activated, only the resources that are actually used are downloaded just at the moment they are rendered. This is done by custom implementations of `WritableFileSystemStorage` and `ProxyAwareFileSystemSymlinkTarget` and works out of the box if you use this storage and target in you local development environment. If you use other local storages, for example a local S3 storage, you can easily build your own proxy aware versions implementing the interfaces `ProxyAwareStorageInterface` and `ProxyAwareTargetInterface`of this package.

Installation
------------

[](#installation)

Sitegeist.Magicwand is available via packagist. Just add `"sitegeist/magicwand" : "~1.0"` to the require-dev section of the composer.json or run `composer require --dev sitegeist/magicwand`. We use semantic-versioning so every breaking change will increase the major-version number.

Contribution
------------

[](#contribution)

We will gladly accept contributions especially to improve the rsync, and ssh-options for a specific preset. Please send us pull requests.

### We will NOT add the following features to the main-repository

[](#we-will-not-add-the-following-features-to-the-main-repository)

- Windows support: We rely on a unix-shell and a filesystem that is capable of hard-links.
- SSH with username/password: We consider this unsafe and recommend the use of public- and private-keys.

###  Health Score

58

—

FairBetter than 98% of packages

Maintenance66

Regular maintenance activity

Popularity46

Moderate usage in the ecosystem

Community30

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 69.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~86 days

Recently: every ~77 days

Total

42

Last Release

174d ago

Major Versions

v1.0.5 → v2.0.02017-01-20

v2.1.1 → v3.0.02018-05-07

v2.2.0 → v3.1.02018-05-29

v3.3.1 → v4.0.02019-02-20

### Community

Maintainers

![](https://www.gravatar.com/avatar/51e0a02d8e12b73949ec858638aa7e295e103022cc5a879f86ac8532c2c170bd?d=identicon)[sitegeist](/maintainers/sitegeist)

![](https://www.gravatar.com/avatar/829b4ccb51e8cff3c1e4b59d60cfe8d1b86f6d77fc31a6b3fc99227f432542ca?d=identicon)[mficzel](/maintainers/mficzel)

---

Top Contributors

[![mficzel](https://avatars.githubusercontent.com/u/1309380?v=4)](https://github.com/mficzel "mficzel (165 commits)")[![grebaldi](https://avatars.githubusercontent.com/u/2522299?v=4)](https://github.com/grebaldi "grebaldi (34 commits)")[![daniellienert](https://avatars.githubusercontent.com/u/642226?v=4)](https://github.com/daniellienert "daniellienert (13 commits)")[![mstruebing](https://avatars.githubusercontent.com/u/12071529?v=4)](https://github.com/mstruebing "mstruebing (10 commits)")[![DrillSergeant](https://avatars.githubusercontent.com/u/883552?v=4)](https://github.com/DrillSergeant "DrillSergeant (4 commits)")[![freesh](https://avatars.githubusercontent.com/u/4658848?v=4)](https://github.com/freesh "freesh (2 commits)")[![fnkr](https://avatars.githubusercontent.com/u/616991?v=4)](https://github.com/fnkr "fnkr (2 commits)")[![paavo](https://avatars.githubusercontent.com/u/1118783?v=4)](https://github.com/paavo "paavo (1 commits)")[![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (1 commits)")[![dlubitz](https://avatars.githubusercontent.com/u/13046100?v=4)](https://github.com/dlubitz "dlubitz (1 commits)")[![jonnitto](https://avatars.githubusercontent.com/u/4510166?v=4)](https://github.com/jonnitto "jonnitto (1 commits)")[![kabarakh](https://avatars.githubusercontent.com/u/1228395?v=4)](https://github.com/kabarakh "kabarakh (1 commits)")[![NamioL](https://avatars.githubusercontent.com/u/17914147?v=4)](https://github.com/NamioL "NamioL (1 commits)")[![nezaniel](https://avatars.githubusercontent.com/u/1687674?v=4)](https://github.com/nezaniel "nezaniel (1 commits)")[![Nikdro](https://avatars.githubusercontent.com/u/9807101?v=4)](https://github.com/Nikdro "Nikdro (1 commits)")

---

Tags

cliclonehacktoberfestneoscmsrestoresshstash

### Embed Badge

![Health badge](/badges/sitegeist-magicwand/health.svg)

```
[![Health](https://phpackages.com/badges/sitegeist-magicwand/health.svg)](https://phpackages.com/packages/sitegeist-magicwand)
```

###  Alternatives

[wp-cli/wp-cli

WP-CLI framework

5.1k17.2M320](/packages/wp-cli-wp-cli)[consolidation/annotated-command

Initialize Symfony Console commands from annotated command class methods.

22569.8M19](/packages/consolidation-annotated-command)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[php-tui/php-tui

Comprehensive TUI library heavily influenced by Ratatui

589747.0k6](/packages/php-tui-php-tui)[codedungeon/php-cli-colors

Liven up you PHP Console Apps with standard colors

10210.1M26](/packages/codedungeon-php-cli-colors)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
