NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #856 most downloaded on pub.dev
Process run helpers for Linux/Win/Mac and which like feature for finding executables.
Latest stable
1.4.4+1
Last release 6 days ago
16 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Some releases are documented
notes for 34 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
147 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
process_run: 1.4.4+1 stdin of a command closing its input, no unhandl…
process_run: 1.4.4+1 stdin of a command closing its input, no unhandl…
ShellOptions(mode: ProcessStartMode.detached) and detachedWithStdio
(the mode of the global runExecutableArguments and of ProcessCmd
too) start a detached process instead of throwing a StateError: the run
ends once the command started, exit code 0 (a detached process has none),
nothing read (with detachedWithStdio the streams are the ones of the
process given to onProcess, unless noStdoutResult: false asks for the
output: the run then ends with it). Shell.kill() leaves such a processstdout: or stderr: sink closed while the command still writes (closed
once a kill() made the run throw, the command taking time to end) no
longer throws an unhandled Cannot add event after closing: it gets
nothing moreShellLinesController.stream, shellStreamLines: a line that is not in
the encoding is no longer dropped (and printed as bytes on stdout): it is
read as UTF-8, its malformed sequences replaced by U+FFFDstdin: given with ProcessStartMode.inheritStdio is ignored (the
process has the terminal), it threw when its first data camestdin: given no longer throws an unhandled SocketException (broken
pipe) when more input comes: the rest is droppeddart:io Process.run and
Process.start (no input, detached start, exit code before the end of the
output, kill keeping the result of the run)Your coding agent can read these notes before it upgrades. Set up the MCP server →
process_run: 1.4.4 detached start, closed output sink, lines never dr…
process_run: 1.4.4 detached start, closed output sink, lines never dr…
ShellOptions(mode: ProcessStartMode.detached) and detachedWithStdio
(the mode of the global runExecutableArguments and of ProcessCmd
too) start a detached process instead of throwing a StateError: the run
ends once the command started, exit code 0 (a detached process has none),
nothing read (with detachedWithStdio the streams are the ones of the
process given to onProcess, unless noStdoutResult: false asks for the
output: the run then ends with it). Shell.kill() leaves such a processstdout: or stderr: sink closed while the command still writes (closed
once a kill() made the run throw, the command taking time to end) no
longer throws an unhandled Cannot add event after closing: it gets
nothing moreShellLinesController.stream, shellStreamLines: a line that is not in
the encoding is no longer dropped (and printed as bytes on stdout): it is
read as UTF-8, its malformed sequences replaced by U+FFFDstdin: given with ProcessStartMode.inheritStdio is ignored (the
process has the terminal), it threw when its first data camedart:io Process.run and
Process.start (no input, detached start, exit code before the end of the
output, kill keeping the result of the run)The shell's own runExecutableArgumentsSync ended its current run (Killed by framework): when kill() hits a command still starting, the command started
The shell's own runExecutableArgumentsSync ended its current run (Killed by
framework): when kill() hits a command still starting, the command started
since was ended (windows CI, 'kill while starting, then a new run'), and
the taskkill command showed in the shell output.
Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_011Mtk7ocTedCc2yusUn8WWq
sharedStdIn: the end of input (and errors) reaches its subscribers. A
command given stdin: sharedStdIn gets its end of input, it hung (or the
program quit silently at the read, exit code 0); prompt, promptConfirm
and nextLine throw a StateError at the end of input (stdin a pipe or
/dev/null). terminate() no longer hangs on input typed while nobody
listenedshellArgument, shellArguments, shellJoin: on posix an argument holding
a backslash is quoted and escaped, and an argument starting with # is
quoted, so that Shell.run reads them backshellStreamLines, ShellLinesController.stream: a listener pausing
(await for) no longer gets each line twiceShell.kill(): a command killed while it starts is killed even when the
shell ran a new command since, and that new command keeps running (on
Windows the taskkill ended it); on Windows the taskkill command no longer
shows in the shell outputstdoutAsUint8List, stderrAsUint8List, pipe(): support the output of a
run without encodingShell.run: a last command ending with \ or ^ is runds env path/var/alias: editing a key with an inline value
(path: ~/bin, var: {A: b}) no longer corrupts the env fileShell and ShellLinesController
(its stdin and its stdout lines) instead of dart:io Process.startA child program to kill (lib/child/child.dart, compileChild()): waits, starts a chain of descendants (--depth), writes ready <pid> once its tree is st
A child program to kill (lib/child/child.dart, compileChild()): waits,
starts a chain of descendants (--depth), writes ready <pid> once its tree
is started, exits with explicit codes on the signals it catches
(--sigterm-exit-code, --sigint-exit-code) or ignores sigterm
(--ignore-sigterm). test/child_test.dart checks Shell.kill() and
ShellProcesses with it: the exit codes (sigkill cannot be caught: -9) and
the processes of the tree gone.
compileEcho() and compileChild() share compileTestExecutable(): the calls
are serialized (concurrent calls compile once), an existing executable is
checked once per process with --version and rebuilt on a version change.
Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_011Mtk7qJpozBUTE19eCrEKW
ShellProcesses (shell.dart), any process of the machine by its pid
on Linux, macOS and Windows: findByExecutable (the running processes of an
executable file), descendantsOf (the children of a process, their
children...), isRunning and kill (sigterm, then sigkill after a
timeout, with the descendants when tree is true)Shell.kill() without a signal (its signal is now
nullable, kill([ProcessSignal? signal])) kills the command and all its
descendants, sigterm first then sigkill for the ones still running after
5 seconds (in the background); on Windows the whole tree at once
(taskkill /t /f). It sent sigterm to the command only, its children kept
running. An explicit signal keeps the previous behavior
(kill(ProcessSignal.sigterm) signals the command only)Shell.kill(ProcessSignal.sigkill) kills all the descendants of the
running command on Linux and macOS (pkill -P sent sigterm to its direct
children only: grandchildren, such as the browser of flutter test, kept
running)process_run: 1.4.1 env files written before 1.4.0 are read back as wr…
process_run: 1.4.1 env files written before 1.4.0 are read back as wr…
a: b no longer makes the whole file unreadable, and an
unquoted number, boolean or empty value keeps its text (007, 1.50, an empty
value used to read back as 7, 1.5 and null)The remote run compiles the ds executable of the pubspec (an AOT bundle, like dart install) in a temporary DART_DATA_HOME: --version and run dart --ve
The remote run compiles the ds executable of the pubspec (an AOT bundle,
like dart install) in a temporary DART_DATA_HOME: --version and
run dart --version (dart found from the bundle).
Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_011Mtk7pQGTUghxXPpNLnzDJ
a: b no longer makes the whole file unreadable, and an
unquoted number, boolean or empty value keeps its text (007, 1.50, an empty
value used to read back as 7, 1.5 and null)Shell.kill writes its killing ... line only when the shell shows its
commands (verbose or commandVerbose), to the shell's stderr when one is
given (it always went to the process stderr)bin/ds.dart (the ds executable now points to it) so that dart run process_run:ds works,
process_run:shell still does; the docs mention dart install process_runcmd.exe cannot start with a fully empty environment on Windows (The parameter is incorrect), keep PATH out so echo is still not resolved.
cmd.exe cannot start with a fully empty environment on Windows
(The parameter is incorrect), keep PATH out so echo is still not
resolved.
Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com
includeParentEnvironment: false keeps
its environment after cd, pushd, shellVarOverride and pipe (the
parent environment came back)pipe and ShellProcessResults.shell (stack overflow), the piped command
now gets the output as its input, endedonProcess ignored by runExecutableArguments (top-level and Shell)userLoadEnv and userLoadEnvFile losing the aliases, userLoadEnv(aliases:)
is now appliedrunExecutableArgumentsSync(throwOnError: true) not throwingrunSync, runExecutableArgumentsSync and
runCommandSyncds env var set and ds env alias set quote the value when needed so that a
value such as a: b no longer corrupts the env file; a var that cannot be set
in the local file is no longer writtenShellEnvironment == (always false)runCmd uses ProcessCmd.mode, devRunCmd uses its stdoutpopd and the comments use the shell stdoutds env --info and ds env alias delete --verbose display the aliasestest: add VM test support for dart_tool_paths_test
test: add VM test support for dart_tool_paths_test
DartToolPaths and the pubCachePath, pubCacheBinPath, dartDataHomePath,
dartInstallPath and dartInstallBinPath getters: where dart pub global activate
and dart install put their files on Linux, macOS and Windows, with the PUB_CACHE
and DART_DATA_HOME overridesCo-Authored-By: Claude Fable 5.1 noreply@anthropic.com Claude-Session: https://claude.ai/code/session_01BeSPt2peAnMDW5fVfk2B6F
Co-Authored-By: Claude Fable 5.1 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01BeSPt2peAnMDW5fVfk2B6F
process-run-environment, process-run-shell and process-run-tools agent skills in skills/, installable with dart run skills@ getSupport nested aliases (an alias can refer to another alias) when resolving the executable of a command, in Shell.run and ds run
Shell.run and ds run <alias> <arguments>ds run ll works with alias ll='ls -alF' defined in
~/.bashrc, ~/.zshrc... The shell is read from the SHELL environment
variable (bash, zsh, sh, dash, ash and ksh variants are
supported), an unsupported shell (fish...) means no fallback. Can be
turned off using userShellAliasEnabledds run --info also dumps the aliasesfeat: update version to 1.3.4+1 and enhance verbose flag handling in …
feat: update version to 1.3.4+1 and enhance verbose flag handling in …
ShellBinCommand.verbose flag resolutionNothing published for this version
process_run: 1.3.3+1 restore runCmd behavior with throwOnError as false
process_run: 1.3.3+1 restore runCmd behavior with throwOnError as false
ShellCommand, ShellCommandRunOption and Shell.runCommandNothing published for this version
Nothing published for this version
Bump version to 1.3.3-2 and update CHANGELOG for new release
Bump version to 1.3.3-2 and update CHANGELOG for new release
Bump version to 1.3.3-1 in version.dart
Bump version to 1.3.3-1 in version.dart
Add ShellProcessResult and ShellProcessResults for proper output decoding
ShellProcessResult and ShellProcessResults for proper output decodingpipe feature to use on Shell.runBump version to 1.3.1+1
Bump version to 1.3.1+1
command info to ShellException and toDebugString() helperNothing published for this version
* ShellContext export * Requires dart 3.10
Nothing published for this version
Nothing published for this version
Nothing published for this version
Allow running in a zoned environment context.
* Requires dart 3.7
Special kill behavior on linux, mac and windows when using sigkill (kills all children too)
ShellOnProcessCallbackNothing published for this version
Nothing published for this version
Add ShellLinesController.binaryStream to allow processing binary data and allow using it for stdin.
ShellLinesController.binaryStream to allow processing binary data and allow using it for stdin.--user flag handling in ds executable.Nothing published for this version
Nothing published for this version
Nothing published for this version
* Export ShellBinCommand * requires dart 3.5
Nothing published for this version
Nothing published for this version
* Remove deprecated methods
Nothing published for this version
Nothing published for this version
Nothing published for this version
add ShellStdio and shellStdioLinesGrouper to allow grouping stdout and stderr lines by zones.
ShellStdio and shellStdioLinesGrouper to allow grouping stdout and stderr lines by zones.Nothing published for this version
Nothing published for this version
Nothing published for this version
add noStdoutResult and noStderrResult to ShellOptions and runExecutableArguments to avoid out of memory for very long output
noStdoutResult and noStderrResult to ShellOptions and runExecutableArguments to avoid out of memory for
very long outputNothing published for this version
Nothing published for this version
add runSync and runExecutableArgumentsSync to global space and to Shell
runSync and runExecutableArgumentsSync to global space and to ShellNothing published for this version
No longer replace \ by \\ before splitting arguments
\ by \\ before splitting argumentsNothing published for this version
Fix finding flutter on windows in unit tests
flutter on windows in unit testscharcode dependency.ShellLinesControllerNothing published for this version
Nothing published for this version
Export stringToArguments in shell.dart
stringToArguments in shell.dart* Dart 3 only
* Dart 3 support
Nothing published for this version
Nothing published for this version
* Fix clone in ShellMixin.
clone in ShellMixin.One column per quarter.