Repository navigation
devcontainer-kit v1.0.0
The first stable release. Interface stays 2; nothing breaks from v0.3.7, so upgrade with
dck init and dck rebuild so the image carries the new pins.
Stability commitment
From 1.0.0 the public interface follows semver: a breaking change to it needs a new major
version (and, for the files below, a new interface number). The public interface is:
- The
dckverbs and flags:init,setup,up,down,stop,start,restart,
ps,logs,shell,exec,build,rebuild,config,ports,ssh,herdr,
host,agents,ask,doctor,--skill,help,--version, their documented flags
(--repo,--profile,--project,--trust,--compose-file,--service, …) and the
exit codes (0 ok, 1 failed, 2 usage, 3 configuration, 4 environment, 5 refused). - The schemas:
dck.tomland the host profile (docs/schema/dck-config-v2.json,
dck-profile-v2.json) and thedck doctor --jsonreport (dck-doctor-v2.json). - The render contract: the files
dck initwrites and owns (devcontainer.jsonkeys,
compose,docker/local/<service>/,dev.sh), thedck:managedmarkers and user blocks it
preserves, and the environment the entrypoint reads.
Internals (lib/, the layer installers, the image's build steps) are not part of it.
Changed
- Pins: herdr-peers v1.0.0 (
HERDR_PEERS_TAG, verified by the sha256 of its
SHA256SUMS,11634ef2…; tag commit3bf118d, 16 files), its first stable release
(protocol 1). - Pins: coding-agents-kit v1.0.0 (
AGENTKIT_TAG; tag commit57b82fa, tarball
sha2561fd86b4f…,SHA256SUMSsha2568995e737…), its first stable release; the
layer's install call (install.sh --no-rc) and its three skills are unchanged. - Pins: deepworkplan-vim v1.0.0 (
DWP_VIM_TAG; tag commitf0929f9,install.sh
sha256d1aaa207…, the value itsSHA256SUMSandinstall.sh.sha256publish), its first
stable release: visible selections, OSC 52 copy without a clipboard tool, no stray start
screen row.
Fixed
- A flaky editor layer no longer fails the image build. The deepworkplan-vim installer
runs with--strict, and one plugin clone that lost a race with the network (seen as
missing: nvim-cmp, orlualine.nvim/nvim-tree.luaaway from the lockfile) failed the
whole build.editor.shnow reruns the installer when--strictreports a plugin problem —
up to 3 attempts, with a growing pause — and then fails the build, loudly; any other
installer failure (a checksum, a refusal) still fails at once. Theimagesscope runs the
retry against a stub installer: one or two flaky attempts recover, three fail, and a
non-plugin failure is never retried. - Docs: every user doc,
AGENTS.md,SECURITY.md,CONTRIBUTING.mdand the dck skill
re-verified against the code (init's base image and marker refusal, the App layout, doctor's
problem list, satellites, PRIMARY mode, presets,dev_sh,node_first, per-developer CLIs);
the README opens with a theme-aware logo (assets/).
Install
git clone --branch v1.0.0 https://github.com/DailybotHQ/devcontainer-kit
./devcontainer-kit/install.shVerify a clone with shasum -a 256 -c SHA256SUMS. Images: ghcr.io/dailybothq/devcontainer-kit-base:{python-3.13,node-24,debian}-v1.0.0 (digests in the images workflow run).