Skip to content
crib is discontinued and no longer actively maintained. Read why. Interested in taking over? Get in touch.

Custom Config Directory

By default crib finds your devcontainer config by walking up from the current directory, looking for .devcontainer/devcontainer.json. If your config lives elsewhere (e.g. you have multiple configs or a non-standard name), use --config / -C to point directly to the folder that contains devcontainer.json:

Terminal window
crib -C .devcontainer-custom up
crib -C .devcontainer-custom shell

To avoid repeating that flag, create a .cribrc file in the directory you run crib from:

.cribrc
config = .devcontainer-custom

An explicit --config on the command line takes precedence over .cribrc.

.cribrc also carries per-project settings for bundled plugins:

# Devcontainer config location (same as --config / -C).
config = .devcontainer-custom
# Package cache providers (see guides/plugins).
cache = npm, pip, go
# Dotfiles overrides (see guides/plugins).
dotfiles.repository = https://github.com/user/work-dotfiles
dotfiles.targetPath = ~/work-dotfiles
dotfiles.installCommand = make install
# Or disable dotfiles for this project:
# dotfiles = false
# Skip specific bundled plugins for this project.
plugins.disable = ssh, dotfiles
# Or disable every bundled plugin:
# plugins = false

Format is one key = value per line. Lines starting with # are comments. See Built-in Plugins for what each plugin does and the full list of names you can pass to plugins.disable.