Skip to main content

Tool to change directory in workspace managed by wstool

Project description

cd to repositories in workspace which is managed by vcstools/wstool.


install via pypi:

$ pip install wstool_cd

add following to your .bashrc or .zshrc:

source `which`


maybe this alias is good:

$ alias wlcd='wstool_cd'

in workspace which is managed by wstool:

$ wstool_cd  # cd to workspace's root
$ wstool_cd repo0  # cd to a repo0

you can set WSTOOL_DEFAULT_WORKSPACE to cd from anywhere:

$ export WSTOOL_DEFAULT_WORKSPACE=$HOME/ros/indigo/src
$ pwd  # not in workspace
$ wstool_cd ros_comm && pwd # if actually not in workspace, cd to default workspace


this is sometimes dangerous, but useful:

$ source `which`
$ wstool cd repo0  # use cd as sub-command of wstool

this works because:

wstool () {
  case "$1" in
    (cd) shift
     wstool_cd $@ ;;
    (*) command wstool $@ ;;


This is demo of using wstool_cd:



Copyright (C) 2015 Kentaro Wada
Released under the MIT license

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wstool_cd-0.16.tar.gz (3.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page