Skip to content

Commit ed64bc7

Browse files
justin808claude
andcommitted
Update documentation to support both mise and asdf version managers
The documentation previously required asdf, but mise is now the recommended modern alternative. Updated to support both version managers with mise as the recommended option. Changes: - Add mise installation instructions alongside asdf - Update all commands to show mise equivalents - Clarify that mise reads from mise.toml (no plugin installation needed) - Update troubleshooting section for both version managers 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 3cab5c4 commit ed64bc7

File tree

1 file changed

+21
-8
lines changed

1 file changed

+21
-8
lines changed

SWITCHING_CI_CONFIGS.md

Lines changed: 21 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -53,15 +53,20 @@ The project runs tests against two configurations:
5353

5454
## Prerequisites
5555

56-
You must have [asdf](https://asdf-vm.com/) installed to manage Ruby and Node versions.
56+
You must have a version manager like [mise](https://mise.jdx.dev/) (recommended) or [asdf](https://asdf-vm.com/) installed to manage Ruby and Node versions.
5757

5858
```bash
59-
# Install asdf if needed (macOS with Homebrew)
59+
# Install mise (recommended, modern alternative to asdf)
60+
brew install mise
61+
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc
62+
source ~/.zshrc
63+
64+
# OR install asdf (legacy option)
6065
brew install asdf
6166
echo -e "\n. $(brew --prefix asdf)/libexec/asdf.sh" >> ~/.zshrc
6267
source ~/.zshrc
6368

64-
# Install plugins
69+
# Install plugins (only needed for asdf, mise reads from mise.toml)
6570
asdf plugin add ruby
6671
asdf plugin add nodejs
6772
```
@@ -102,7 +107,7 @@ This will:
102107
```bash
103108
# Reload your shell to pick up new Ruby/Node versions
104109
cd /Users/justin/conductor/react_on_rails/.conductor/kuwait-v1
105-
asdf current
110+
mise current # or: asdf current
106111

107112
# Build and test
108113
rake node_package
@@ -132,7 +137,7 @@ This will:
132137
```bash
133138
# Reload your shell to pick up new Ruby/Node versions
134139
cd /Users/justin/conductor/react_on_rails/.conductor/kuwait-v1
135-
asdf current
140+
mise current # or: asdf current
136141

137142
# Build and test
138143
rake node_package
@@ -210,19 +215,27 @@ bin/ci-switch-config latest
210215

211216
## Troubleshooting
212217

213-
### "asdf: No version is set for ruby"
218+
### "No version is set for ruby" or version didn't change
214219

215220
After switching, you need to reload your shell:
216221

217222
```bash
218223
cd /Users/justin/conductor/react_on_rails/.conductor/kuwait-v1
219-
# The cd command will trigger asdf to load the new versions
224+
# The cd command will trigger mise/asdf to load the new versions
220225
ruby --version # Verify it changed
221226
```
222227

223228
### Ruby/Node version didn't change
224229

225-
If asdf doesn't automatically switch:
230+
If your version manager doesn't automatically switch:
231+
232+
**For mise:**
233+
234+
```bash
235+
mise install # Install missing versions from mise.toml or .tool-versions
236+
```
237+
238+
**For asdf:**
226239

227240
```bash
228241
asdf install # Install missing versions from .tool-versions

0 commit comments

Comments
 (0)