Skip to content

docs: replace unused dotfiles_installCommand config option with dotfiles_install_command - #37

Open
AlexTMjugador wants to merge 2 commits into
erichlf:mainfrom
AlexTMjugador:fix/install-command-docs
Open

docs: replace unused dotfiles_installCommand config option with dotfiles_install_command#37
AlexTMjugador wants to merge 2 commits into
erichlf:mainfrom
AlexTMjugador:fix/install-command-docs

Conversation

@AlexTMjugador

@AlexTMjugador AlexTMjugador commented Aug 10, 2026

Copy link
Copy Markdown

Ever since documentation and devcontainer CLI launching code was reworked on
43ae866#diff-1b38a8285e8e71b146aa9a90a37fa3edf2d5d7ec1ccb76c21c0427b245c9c434R156, devcontainer-cli.nvim reads the install command value from the dotfiles_install_command config variable, instead of the dotfiles_installCommand variable documented everywhere else.

This bug usually does not affect functionality because the devcontainer CLI falls back to a list of well-known install
commands
when an install command is not set explicitly. However, as soon as an attempt to use dotfiles_installCommand to set a non-conventional install command is made, the bug obviously surfaces after paying attention to the devcontainer CLI output.

This change fixes the mismatch by updating the documentation to match the variable actually used in the code, and dropping the useless dotfiles_installCommand default from the default_config table, with a comment noting the devcontainer CLI fallback behavior the plugin was relying on. I have decided against modifying the code to match the documentation instead because I recognize that maybe I'm not the first person to notice this mismatch, and as such it's possible that there is some plugin configuration out there depending on the variable name that already works.

Summary by CodeRabbit

  • Bug Fixes

    • Updated the dotfiles installation configuration key to the correct naming format.
    • Enabled the CLI to select the appropriate dotfiles installation command when the setting is not explicitly configured.
  • Documentation

    • Updated configuration guidance and FAQ references to match the corrected setting name.
    • Documented that the default installation command is selected by the Dev Container CLI.

…tfiles_install_command`

Ever since documentation and devcontainer CLI launching code was
reworked on
erichlf@43ae866#diff-1b38a8285e8e71b146aa9a90a37fa3edf2d5d7ec1ccb76c21c0427b245c9c434R156,
`devcontainer-cli.nvim` reads the install command value from the
`dotfiles_install_command` config variable, instead of the
`dotfiles_installCommand` variable documented everywhere else.

This bug usually does not affect functionality because the devcontainer
CLI [falls back to a list of well-known install
commands](https://github.com/devcontainers/cli/blob/58be9705761d276b5076525438bbe73642f521d5/src/spec-common/dotfiles.ts#L11-L20)
when an install command is not set explicitly. However, as soon as an
attempt to use `dotfiles_installCommand` to set a non-conventional
install command is made, the bug obviously surfaces after paying
attention to the devcontainer CLI output.

This change fixes the mismatch by updating the documentation to match
the variable actually used in the code, and dropping the useless
`dotfiles_installCommand` default from the `default_config` table, with
a comment noting the devcontainer CLI fallback behavior the plugin was
relying on. I have decided against modifying the code to match the
documentation instead because I recognize that maybe I'm not the first
person to notice this mismatch, and as such it's possible that there is
some plugin configuration out there depending on the variable name that
already works.
@AlexTMjugador AlexTMjugador changed the title docs: replace unused dotfiles_installCommand config option with `do… docs: replace unused dotfiles_installCommand config option with dotfiles_install_command Aug 10, 2026
@coderabbitai

coderabbitai Bot commented Aug 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 32069a09-2469-46d3-ad7b-3f2d48c36de8

📥 Commits

Reviewing files that changed from the base of the PR and between f0ff86d and dba0368.

📒 Files selected for processing (1)
  • README.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

📝 Walkthrough

Walkthrough

The dotfiles installation option now uses dotfiles_install_command in the Lua configuration and README. The documented default changed to nil, allowing the Dev Container CLI to select the installation command.

Changes

Dotfiles option rename

Layer / File(s) Summary
Rename dotfiles installation option
lua/devcontainer-cli/config.lua, README.md
The configuration key and README references now use dotfiles_install_command. The Lua setting is commented out, and the documented default is nil.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the configuration key rename and removal of the unused option documented and defined in the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 131: Update the README entries for dotfiles_install_command to document
that its default is unset rather than "install.sh", and explain that omitting
the option allows the Dev Container CLI to select its well-known install
command. Apply the same correction to both referenced occurrences.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: b3aa867b-2239-4af1-9f03-762501971a88

📥 Commits

Reviewing files that changed from the base of the PR and between 00b08c1 and f0ff86d.

📒 Files selected for processing (2)
  • README.md
  • lua/devcontainer-cli/config.lua

Comment thread README.md Outdated
@erichlf

erichlf commented Aug 11, 2026

Copy link
Copy Markdown
Owner

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Aug 11, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@erichlf erichlf left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants