devcontainer-sync-cli

A CLI tool for syncing devcontainer configurations from the Claude Code repository.

⚠️ At the time of writing, the implementation will include a iptables-based firewall. Use --strip-firewall to remove it if not needed.

Usage

# Initialize devcontainer sync in your git repository
devcontainer-sync init

# Initialize without firewall configurations
devcontainer-sync init --strip-firewall

# Update to latest devcontainer configurations
devcontainer-sync update

# Update and remove firewall configurations
devcontainer-sync update --strip-firewall

# Remove devcontainer sync (keeps files by default)
devcontainer-sync remove

Options

• --verbose, -v: Show detailed output
• --strip-firewall: Remove firewall configurations from devcontainer files (init/update only)
• update --backup: Create backup before updating
• remove --keep-files: Keep devcontainer files when removing sync

Why?

The Claude Code Best Practices docs say recommend using devcontainers, and to copy the implementation in the main Claude Code repo. As we all know, whenever you copy/paste from a Git repo a fairy dies, and instead we should be able to pull down updates if Anthropic change their implementation. Doing this 'by hand' is a bit of a faff:

git remote add claude https://github.com/anthropics/claude-code.git
git fetch claude
git branch -f claude-main claude/main
git checkout claude-main
git subtree split --prefix=.devcontainer -b devcontainer claude-main
git checkout master
# Will fail if there wasn't a commit already
git subtree add --prefix=.devcontainer devcontainer --squash

This CLI does all this fiddly-faff for you.

Releases

Releases are automated. Every push to master that passes CI will automatically bump the patch version, create a tag, and publish a GitHub Release with binaries.