sip_cli

Features

• Add sip validate, which checks scripts.yaml without running anything and reports each problem against the line it was written on. It catches unresolvable references, malformed substitutions (${{ a:b }}, which sip passes to the shell verbatim), circular references, invalid script names, aliases claimed twice, keys that look reserved but are not, a valueless (bail) that reads as false, and scripts with nothing to run. Errors exit 78; --fatal-warnings makes warnings do the same. --json gives every diagnostic a stable code and location.
• Add --json to sip list, printing every script as a flat list: its dotted key, the path to pass to sip run, aliases, description, private and runnable flags, bail, the raw commands as written, the fully resolved commands with their concurrency, env, and the scripts.yaml line and column it was declared on. --no-resolve skips expansion, and a query still filters the listing.
• Add --json to sip run <script> --print, emitting the resolved commands for a single script.
• Add --json to sip test, reporting counts and the file, test name and message for each failure. Failures that are not test failures -- a compile error, a crashed runner, output sip could not parse -- are reported separately, so an empty failure list does not read as a passing run.
• Add sip mcp, which runs sip as an MCP server over stdio and exposes this project's scripts to an AI coding assistant as tools: list_scripts, dry_run, run_script and validate. run_script takes a script name, never a command, so it cannot run anything not declared in scripts.yaml.
• Add sip ai agents, which writes AGENTS.md -- the convention Codex, Cursor, Copilot, Zed and Amp read. sip ai all includes it.

Enhancements

• sip no longer forces ANSI colour on. Output is plain when stdout is not a terminal, so piping sip list no longer hands the reader a tree full of escape codes. --color/--no-color, NO_COLOR, FORCE_COLOR and TERM=dumb override the guess.
• The "a new version is available" notice moved to stderr and is skipped entirely, along with its network request, when stdout is not a terminal. Previously it went to stdout on every command -- for a failed run it was the only thing on stdout. --no-version-check and SIP_NO_VERSION_CHECK also turn it off.

Fixes

• Fix flags that take no value swallowing the argument that follows them. sip test --omit-errors test/a_test.dart test/b_test.dart set --omit-errors to test/a_test.dart and dropped that file from the run, and when only one path followed the flag, the run fell back to testing the entire package. Every flag sip reads as a boolean is now parsed as such and leaves the following argument alone. Flags sip doesn't know about still take a value, so unknown dart test / flutter test options are forwarded as before. The same fix applies to boolean abbreviations (-b, -d, -l, -r), which also fixes sip pub upgrade --tighten <package> and sip pub constrain -d <package> losing their first package name.

Enhancements

• Experimental, opt-in: Add --experimental-bucket to sip test for Flutter packages, combining test files into ~CPU-core-count generated bucket files (dispatched as one flutter test invocation per shard) to cut per-file VM-isolate startup overhead, the same idea as the existing Dart-only test optimizer. Files that can't be safely combined (unsafe TestWidgetsFlutterBinding subtypes, or test-surface mutation without a reset) always run in their own isolated wrapper, never sharing an isolate with anything else. If a bucket's combined run looks untrustworthy (a compile error or a hard binding assertion cuts it short, so one of its files never reports a result), just that bucket's original files are automatically discarded and re-run individually, logged clearly, while every other healthy bucket sharing the same invocation is left untouched. This covers the two known combining hazards, but not arbitrary global test-state leakage (e.g. an unreset image cache) between files sharing an isolate -- that class of bug can't be caught by a static check or the runtime fallback, so treat a bucketed run as a strong signal, not an absolute guarantee of unbucketed-equivalent results. Also adds --bucket-count, --bucket-shard-index, and --bucket-shard-count for splitting buckets across CI matrix jobs. Off by default; Dart packages and existing behavior are completely unaffected.

Fixes

• Fix issue where running multiple concurrent commands would hang indefinitely
  • Thanks for your contribution @supposedlysam

Fixes

• Fix issue where analytics would hang indefinitely

Enhancements

• Improve test output formatting when using --omit-errors flag to show formatted path and test description with colors
• Use same simple path | test format (without truncation) for failing tests when --omit-errors is not enabled, while still showing error output

Fixes

• Fix display path in test output to show the correct path when running sip test <path> instead of always showing ./.
• Fix display path to show . when running sip test with no arguments or with . argument
• Fix test output to wrap text correctly when the terminal width is smaller than the text length

Enhancements

• When ., test, or no path argument is provided to sip test, run the test command without forwarding all test directories (e.g., flutter test instead of flutter test test/utils test/other)

Fixes

• Issue where sip update command was not working

Fixes

• Issue where exception was thrown when no pubspec.yaml file was found while trying to resolve variables

Fixes

• Issue where exit code was not set when a non-last command failed

Breaking Changes

• Remove test watch command
• Deprecate {$path:...} and {--flag} syntax for referencing scripts
  • This will be removed in the next major version
  • Prefer to use ${{ path.script_name }} and ${{ --flag }} syntax instead

Fixes

• Adds check & exit for when dart compiler exits unexpectedly
• Adds listener & register for when the process is interrupted
  • Handles cleaning up resources

Enhancements

• Formatting output for tests
• Add more detailed logs when running with --loud flag
• Update dependencies
• Improve test output formatting
• Improve script output formatting

Features

• Support --bail for flutter tests
• Add --slice flag for flutter tests
  • Separates test directories into chuncks to run them concurrently, useful for large test suites and decreasing the time to run tests
• Add analytics lukehog
• Pass --help flag within sip run <path> to print the usage information for the script
• Reformat test output on CI

Fixes

• Issue where exception thrown on CI preventing the script from running

Enhancements

• Dependency Updates

Fixes

• Issue where logs were being consumed in CI environments

Fixes

• Issue where test would be blank when tests were skipped

Fixes

• Issue where test output was empty when it shouldn't be

Enhancements

• Add relative path to project root in test output

Enhancements

• Add env variables to env after sourcing the env file
• Improve test output formatting

Fixes

• Issue where env commands were not being resolved correctly

Enhancements

• Always show the cursor when the process is interrupted
  • Sometimes the cursor would not be visible when the process was interrupted and the cursor would remain hidden

Fixes

• Issue where a reference command that contains concurrency would loop indefinitely

Fixes

• Crash when a reference does not contain any commands to run

Fixes

• Issue where a command following a non-concurrent command would be skipped

Fixes

• Issue where env would not be resolved completely if there were no env commands
• Issue where concurrency commands resolution would fail when env configs were present

Enhancements

• Improve "There's a new version available" message

Features

• Add support for defining env variables within (env)

Fixes

• Issue where a command that contains variables/flags would be skipped when following a concurrent command

Enhancements

• Add --print flag to sip run command
  • Prints out the commands that would be run without executing them

Enhancements

• When running pub commands, ignore pubspecs within directories that start with a dot
• Add working directory to error output
• Add index of command to error output

Fixes

• Issue where concurrency commands could run sequentially, unintentionally

Features

• Scope concurrency to original scripts
• Add listener to watch for SIGINT signal to stop the process

Fix

• Fix issue where test directories were not identified correctly when parent directory starts withtest

Features

• Add executables to variables to be used in commands

  (executables):
    flutter: fvm flutter
    dart: fvm dart
  
  build_runner: "{dart} run build_runner build"
  

Features

• Add support to sip pub constrain command to constrain specific packages to a specific version
• Add support to sip pub constrain command to unpin (--no-pin)
  • e.g. provider: 5.0.0 will be unpinned to ^5.0.0

Features

• Don't exit with non-zero when no test directories are found

Features

• Flutter tests respect the --bail flag during sip test command
  • If a test fails, the command will stop running tests and exit with a non-zero exit code

Fixes

• Issue where formatting test output could result in an exception thrown

Enhancements

• Improve the output when running flutter tests
• Improve the output when running dart tests

Features

• Override dart and flutter executable by using (executables) within the `scripts.yaml file

(executables):
  dart: fvm dart
  flutter: fvm flutter

Enhancements

• Ignore build and dart tool directories when running pub commands

Fixes

• Check for empty tests when no dart/flutter tests are found when targeting dart/flutter tests only

Fixes

• Bug where env reference commands may not be resolved
• Bug that did not remove concurrency symbols from env file commands

Features

• Check for dependencies when running sip pub upgrade <packages>
  • If the package is not found in the pubspec.yaml file, that pubspec.yaml file will be skipped

Features

• Pin versions of packages by providing the --pin flag to the constrain command
  • e.g. sip pub constrain --pin will pin all packages to their current versions

Features

• Constrain certain packages by providing their package names to the constrain command
  • e.g. sip pub constrain analyzer test will constrain only the analyzer and test packages

Features

• Support querying scripts from sip list
  • Usage: sip list [query] [arguments]
  • Searches for
    • Script keys that contain the query string
    • Aliases that match the query string
    • Descriptions that contain the query string

Fixes

• sip update should now update to the latest version properly

Features

• Pass packages to sip pub upgrade when provided
  • e.g. sip pub upgrade analyzer test will run <dart|flutter> pub upgrade analyzer test
• Create new sip pub constrain command
  • Constrains all dependency versions in the pubspec.yaml file
• Create new sip pub deps command
  • Lists all dependencies in the pubspec.yaml file by running <dart|flutter> pub deps
• Add --unlock-transitive flag to sip pub upgrade command
  • This will unlock all transitive dependencies when upgrading packages
• Create new sip pub downgrade command
  • Downgrades all dependencies in the pubspec.yaml file by running <dart|flutter> pub downgrade

Enhancements

• Always include a space after the label when running scripts concurrently to format the output better