diff --git a/plugins/.gitignore b/plugins/.gitignore
index ba6a5bc5..e2092085 100644
--- a/plugins/.gitignore
+++ b/plugins/.gitignore
@@ -1,4 +1,4 @@
 /*
 !/.gitignore
-!/pyenv-version-ext
+!/version-ext-compat
 !/python-build
diff --git a/plugins/pyenv-version-ext/README.md b/plugins/version-ext-compat/README.md
similarity index 67%
rename from plugins/pyenv-version-ext/README.md
rename to plugins/version-ext-compat/README.md
index 7f96d405..ac8ef824 100644
--- a/plugins/pyenv-version-ext/README.md
+++ b/plugins/version-ext-compat/README.md
@@ -4,13 +4,24 @@ pyenv-version-ext is a [pyenv](https://github.com/yyuu/pyenv) plugin
 that provides a `pyenv push` and `pyenv pop` commands to manage Python
 versions.
 
+(NOTICE:
+This project has been moved out as external plugin of pyenv.
+The version-ext-compat has left for backward compatibility, but will be removed from future release of pyenv.
+See also [pyenv-version-ext](https://github.com/yyuu/pyenv-version-ext).)
+
 ## Installation
 
-### Installing as an pyenv plugin (recommended)
+### Installing as an pyenv plugin
+
+Installing pyenv-version-ext as a pyenv plugin will give you access to the
+`pyenv push` and `pyenv pop` commands.
 
-You need nothing to do since python-build is bundled with pyenv by
-default.
+    $ git clone git://github.com/yyuu/pyenv-version-ext.git ~/.pyenv/plugins/pyenv-version-ext
 
+This will install the latest development version of pyenv-version-ext into
+the `~/.pyenv/plugins/pyenv-version-ext` directory. From that directory, you
+can check out a specific release tag. To update pyenv-version-ext, run `git
+pull` to download the latest changes.
 
 ## Usage
 
diff --git a/plugins/pyenv-version-ext/bin/pyenv-sh-pop b/plugins/version-ext-compat/bin/pyenv-sh-pop
similarity index 79%
rename from plugins/pyenv-version-ext/bin/pyenv-sh-pop
rename to plugins/version-ext-compat/bin/pyenv-sh-pop
index cf39750a..8c53a7f7 100755
--- a/plugins/pyenv-version-ext/bin/pyenv-sh-pop
+++ b/plugins/version-ext-compat/bin/pyenv-sh-pop
@@ -5,6 +5,8 @@ set -e
 
 IFS=: versions=($(pyenv-version-name))
 
+echo "WARNING: The \`pop' command will be removed from pyenv. Please install https://github.com/yyuu/pyenv-version-ext." 1>&2
+
 length="${#versions[@]}"
 PYENV_VERSION_NAMES=()
 for ((i=0; i<length-1; i++)); do
diff --git a/plugins/pyenv-version-ext/bin/pyenv-sh-push b/plugins/version-ext-compat/bin/pyenv-sh-push
similarity index 77%
rename from plugins/pyenv-version-ext/bin/pyenv-sh-push
rename to plugins/version-ext-compat/bin/pyenv-sh-push
index 9b2f4944..7cd83980 100755
--- a/plugins/pyenv-version-ext/bin/pyenv-sh-push
+++ b/plugins/version-ext-compat/bin/pyenv-sh-push
@@ -7,6 +7,8 @@ IFS=: PYENV_VERSION_NAMES=($(pyenv-version-name))
 versions=("$@")
 PYENV_VERSION_NAMES=("${PYENV_VERSION_NAMES[@]}" "${versions[@]}")
 
+echo "WARNING: The \`push' command will be removed from pyenv. Please install https://github.com/yyuu/pyenv-version-ext." 1>&2
+
 if [ -n "$PYENV_VERSION" ]; then
   IFS=: PYENV_VERSION="${PYENV_VERSION_NAMES[*]}"
   echo "export PYENV_VERSION=\"${PYENV_VERSION}\""
diff --git a/plugins/pyenv-version-ext/install.sh b/plugins/version-ext-compat/install.sh
similarity index 100%
rename from plugins/pyenv-version-ext/install.sh
rename to plugins/version-ext-compat/install.sh