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.

…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

Warning

Review limit reached

@AlexTMjugador, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 38 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 0a6af4ff-3606-4750-aa98-aaf9d4c5aa47

📥 Commits

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

📒 Files selected for processing (1)
  • README.md
📝 Walkthrough

Walkthrough

The dotfiles installation configuration key was renamed from dotfiles_installCommand to dotfiles_install_command in the Lua configuration and README references. The Lua setting is now commented out.

Changes

Dotfiles option rename

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

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 and concisely describes the main configuration-key rename and its documentation update.
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
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.

1 participant