Skip to content

Deprecate set windows-shell #3536

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
casey merged 2 commits into from
Jul 6, 2026
Merged

Deprecate set windows-shell #3536

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
56ab385
Deprecate `windows-shell` setting
casey Jul 6, 2026
06c049a
Reform
casey Jul 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 10 additions & 25 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2856,7 +2856,8 @@ Here's a justfile with a recipe indented with spaces, represented as `·`, and
tabs, represented as `→`.

```justfile
set windows-shell := ["pwsh", "-NoLogo", "-NoProfileLoadTime", "-Command"]
[windows]
set shell := ["pwsh", "-NoLogo", "-NoProfileLoadTime", "-Command"]

set ignore-comments

Expand Down Expand Up @@ -3084,13 +3085,12 @@ from highest to lowest, is:

1. The `--shell` and `--shell-arg` command line options. Passing either of
these will cause `just` to ignore any settings in the current justfile.
2. `set windows-shell := [...]`
2. `set windows-shell := [...]` (deprecated)
3. `set windows-powershell` (deprecated)
4. `set shell := [...]`

Since `set windows-shell` has higher precedence than `set shell`, you can use
`set windows-shell` to pick a shell on Windows, and `set shell` to pick a shell
for all other platforms.
Use the `[windows]` and `[unix]` attributes with `set shell` to use different a
shells on Windows.

### Shell

Expand All @@ -3115,10 +3115,11 @@ an additional flag, often `-c`, to make them evaluate the first argument.
#### Windows Shell

`just` uses `sh` on Windows by default. To use a different shell on Windows,
use `windows-shell`:
use the `[windows]` attribute on the `shell` setting:

```just
set windows-shell := ["powershell.exe", "-NoLogo", "-Command"]
[windows]
set shell := ["powershell.exe", "-NoLogo", "-Command"]

hello:
Write-Host "Hello, world!"
Expand All @@ -3128,22 +3129,6 @@ See
[powershell.just](https://github.com/casey/just/blob/master/examples/powershell.just)
for a justfile that uses PowerShell on all platforms.

#### Windows PowerShell

*`set windows-powershell` uses the legacy `powershell.exe` binary, and is no
longer recommended. See the `windows-shell` setting above for a more flexible
way to control which shell is used on Windows.*

`just` uses `sh` on Windows by default. To use `powershell.exe` instead, set
`windows-powershell` to true.

```just
set windows-powershell := true

hello:
Write-Host "Hello, world!"
```

#### Python 3

```just
Expand Down Expand Up @@ -4817,8 +4802,8 @@ foo:
| `shell` | `[COMMAND, ARGS…]` | - | Set command used to invoke recipes and evaluate backticks. |
| `tempdir` | string | - | Create temporary directories in `tempdir` instead of the system default temporary directory. |
| `unstable`<sup>1.31.0</sup> | boolean | `false` | Enable unstable features. |
| `windows-powershell` | boolean | `false` | Use PowerShell on Windows as default shell. (Deprecated. Use `windows-shell` instead.) |
| `windows-shell` | `[COMMAND, ARGS…]` | - | Set the command used to invoke recipes and evaluate backticks. |
| `windows-powershell` | boolean | `false` | Use PowerShell on Windows as default shell. (Deprecated. Use the `[windows]` attribute on `set shell`.) |
| `windows-shell` | `[COMMAND, ARGS…]` | - | Set the command used to invoke recipes and evaluate backticks. (Deprecated. Use the `[windows]` attribute on `set shell`.) |
| `working-directory`<sup>1.33.0</sup> | string | - | Set the working directory for recipes and backticks, relative to the default working directory. |

Boolean settings can be written as:
Expand Down
Loading