[{"data":1,"prerenderedAt":878},["ShallowReactive",2],{"docs-page:\u002Fdocs\u002Fcli\u002Frun":3,"docs-pages":531},{"id":4,"title":5,"body":6,"description":489,"extension":524,"meta":525,"navigation":526,"path":527,"seo":528,"stem":529,"__hash__":530},"docs\u002Fdocs\u002Fcli\u002Frun.md","scpm run",{"type":7,"value":8,"toc":488},"minimark",[9,16,30,34,39,46,49,60,66,69,73,79,82,88,95,101,106,112,115,118,124,127,133,136,146,152,155,170,176,179,182,187,193,196,202,205,212,217,220,223,229,232,238,244,247,257,263,266,280,286,289,295,298,304,307,313,316,338,344,347,372,378,381,394,400,403,415,421,424,445,451,454,457,463,466,472,478,481],[10,11,13],"h1",{"id":12},"scpm-run",[14,15,5],"code",{},[17,18,19],"ul",{},[20,21,22,26,27],"li",{},[23,24,25],"strong",{},"Usage",": ",[14,28,29],{},"scpm run [FLAGS] [SCRIPT] [ARGS]…",[31,32,33],"p",{},"Run a script defined in package.json",[35,36,38],"h2",{"id":37},"arguments","Arguments",[40,41,43],"h3",{"id":42},"script",[14,44,45],{},"[SCRIPT]",[31,47,48],{},"Script or local binary name.",[31,50,51,52,55,56,59],{},"Omit on an interactive TTY to pick from ",[14,53,54],{},"package.json"," scripts. If no script matches, scpm falls back to ",[14,57,58],{},"node_modules\u002F.bin\u002F\u003Cname>",".",[40,61,63],{"id":62},"args",[14,64,65],{},"[ARGS]…",[31,67,68],{},"Arguments to pass to the script",[35,70,72],{"id":71},"flags","Flags",[40,74,76],{"id":75},"if-present",[14,77,78],{},"--if-present",[31,80,81],{},"Don't error if the script is missing from package.json",[40,83,85],{"id":84},"inspect-hostport",[14,86,87],{},"--inspect [[HOST:]PORT]",[31,89,90,91,94],{},"Forward ",[14,92,93],{},"--inspect"," to a Node-backed script or local binary",[40,96,98],{"id":97},"inspect-brk-hostport",[14,99,100],{},"--inspect-brk [[HOST:]PORT]",[31,102,90,103,94],{},[14,104,105],{},"--inspect-brk",[40,107,109],{"id":108},"no-bail",[14,110,111],{},"--no-bail",[31,113,114],{},"Continue recursive execution after a script fails.",[31,116,117],{},"Parsed for pnpm compatibility; scpm's sequential fanout still stops on first failure.",[40,119,121],{"id":120},"no-install",[14,122,123],{},"--no-install",[31,125,126],{},"Skip auto-install check",[40,128,130],{"id":129},"no-sort",[14,131,132],{},"--no-sort",[31,134,135],{},"Disable topological sorting (default is on).",[31,137,138,139,142,143,145],{},"Without this, recursive runs visit packages in a deps-first order so a ",[14,140,141],{},"build"," script in a shared library finishes before a dependent app's ",[14,144,141],{}," starts. Pass this to fall back to the raw workspace-listing order.",[40,147,149],{"id":148},"parallel",[14,150,151],{},"--parallel",[31,153,154],{},"Run the script in every matched workspace package concurrently.",[31,156,157,158,161,162,165,166,169],{},"Unbounded parallelism. Pair with ",[14,159,160],{},"--workspace-concurrency=N"," to cap the worker count. Single-package runs ignore this flag. First non-zero exit fails the whole run, but siblings are allowed to finish so their output isn't truncated. Child stdio is piped and lines are emitted with a ",[14,163,164],{},"\u003Cpackage>: "," prefix; pass ",[14,167,168],{},"--reporter-hide-prefix"," to drop the labels.",[40,171,173],{"id":172},"report-summary",[14,174,175],{},"--report-summary",[31,177,178],{},"Write a recursive run summary file.",[31,180,181],{},"Parsed for pnpm compatibility.",[40,183,185],{"id":184},"reporter-hide-prefix",[14,186,168],{},[31,188,189,190,192],{},"Hide the ",[14,191,164],{}," label on parallel-run output lines.",[31,194,195],{},"Lines are still piped through scpm (so the line breaks are clean even when many packages run at once), but the source package isn't named on each line. Sequential runs ignore this flag.",[40,197,199],{"id":198},"resume-from-package",[14,200,201],{},"--resume-from \u003CPACKAGE>",[31,203,204],{},"Resume recursive execution starting at this package name.",[31,206,207,208,211],{},"After the topo sort and ",[14,209,210],{},"--reverse"," are applied, packages before the named one in the resulting order are skipped. Errors if the name isn't in the matched workspace set.",[40,213,215],{"id":214},"reverse",[14,216,210],{},[31,218,219],{},"Reverse the recursive execution order (after topo sort).",[31,221,222],{},"Useful for teardown-style scripts where dependents must shut down before their deps.",[40,224,226],{"id":225},"sort",[14,227,228],{},"--sort",[31,230,231],{},"Sort recursive packages topologically (this is the default).",[31,233,234,235,237],{},"Pass to override an earlier ",[14,236,132],{}," on the same invocation.",[40,239,241],{"id":240},"s",[14,242,243],{},"-s",[31,245,246],{},"Suppress scpm's wrapper output while still showing script stdout\u002Fstderr.",[31,248,249,250,253,254,256],{},"Short alias for the global ",[14,251,252],{},"--silent"," flag; long form is intentionally omitted to avoid shadowing the global ",[14,255,252],{}," in clap's dispatch.",[40,258,260],{"id":259},"workspace-concurrency-n",[14,261,262],{},"--workspace-concurrency \u003CN>",[31,264,265],{},"Cap the number of recursive packages running at once.",[31,267,268,269,272,273,276,277,279],{},"Setting this implicitly enables parallel mode at width ",[14,270,271],{},"N",". ",[14,274,275],{},"0"," means \"use the available CPU count\". Without this flag, ",[14,278,151],{}," stays unbounded.",[40,281,283],{"id":282},"frozen-lockfile",[14,284,285],{},"--frozen-lockfile",[31,287,288],{},"Error if the lockfile drifts from package.json",[40,290,292],{"id":291},"no-frozen-lockfile",[14,293,294],{},"--no-frozen-lockfile",[31,296,297],{},"Always re-resolve, even if the lockfile is up to date",[40,299,301],{"id":300},"prefer-frozen-lockfile",[14,302,303],{},"--prefer-frozen-lockfile",[31,305,306],{},"Use the lockfile when fresh, re-resolve when stale",[40,308,310],{"id":309},"fetch-retries-n",[14,311,312],{},"--fetch-retries \u003CN>",[31,314,315],{},"Number of retry attempts for failed registry fetches.",[31,317,318,319,322,323,326,327,322,330,333,334,337],{},"Overrides ",[14,320,321],{},"fetchRetries"," \u002F ",[14,324,325],{},"fetch-retries"," from ",[14,328,329],{},".npmrc",[14,331,332],{},"scpm-workspace.yaml"," when set. Pair with ",[14,335,336],{},"--fetch-timeout"," to fail fast in scripted test runs.",[40,339,341],{"id":340},"fetch-retry-factor-n",[14,342,343],{},"--fetch-retry-factor \u003CN>",[31,345,346],{},"Exponential backoff factor between retry attempts.",[31,348,318,349,322,352,326,355,322,357,359,360,363,364,367,368,371],{},[14,350,351],{},"fetchRetryFactor",[14,353,354],{},"fetch-retry-factor",[14,356,329],{},[14,358,332],{}," when set. Integer-only — the underlying ",[14,361,362],{},"FetchPolicy.retry_factor"," is ",[14,365,366],{},"u32",". Fractional values like ",[14,369,370],{},"1.5"," are rejected by clap.",[40,373,375],{"id":374},"fetch-retry-maxtimeout-ms",[14,376,377],{},"--fetch-retry-maxtimeout \u003CMS>",[31,379,380],{},"Upper bound (ms) on the computed retry backoff.",[31,382,318,383,322,386,326,389,322,391,393],{},[14,384,385],{},"fetchRetryMaxtimeout",[14,387,388],{},"fetch-retry-maxtimeout",[14,390,329],{},[14,392,332],{}," when set.",[40,395,397],{"id":396},"fetch-retry-mintimeout-ms",[14,398,399],{},"--fetch-retry-mintimeout \u003CMS>",[31,401,402],{},"Lower bound (ms) on the computed retry backoff.",[31,404,318,405,322,408,326,411,322,413,393],{},[14,406,407],{},"fetchRetryMintimeout",[14,409,410],{},"fetch-retry-mintimeout",[14,412,329],{},[14,414,332],{},[40,416,418],{"id":417},"fetch-timeout-ms",[14,419,420],{},"--fetch-timeout \u003CMS>",[31,422,423],{},"Per-request HTTP timeout in milliseconds.",[31,425,318,426,322,429,326,432,322,434,436,437,440,441,444],{},[14,427,428],{},"fetchTimeout",[14,430,431],{},"fetch-timeout",[14,433,329],{},[14,435,332],{}," when set. Applied via ",[14,438,439],{},"reqwest","'s ",[14,442,443],{},".timeout()"," so it covers headers + body together.",[40,446,448],{"id":447},"registry-url",[14,449,450],{},"--registry \u003CURL>",[31,452,453],{},"Override the default registry URL for this invocation.",[31,455,456],{},"Use this npm registry URL for package metadata, tarballs, audit requests, dist-tags, and registry writes.",[40,458,460],{"id":459},"disable-global-virtual-store",[14,461,462],{},"--disable-global-virtual-store",[31,464,465],{},"Force the shared global virtual store off for this invocation.",[31,467,468,469,59],{},"Packages are materialized inside the project's virtual store instead of symlinked from ",[14,470,471],{},"~\u002F.cache\u002Fscpm\u002Fvirtual-store\u002F",[40,473,475],{"id":474},"enable-global-virtual-store",[14,476,477],{},"--enable-global-virtual-store",[31,479,480],{},"Force the shared global virtual store on for this invocation.",[31,482,483,484,487],{},"Overrides CI's default per-project materialization and the ",[14,485,486],{},"disableGlobalVirtualStoreForPackages"," auto-disable heuristic.",{"title":489,"searchDepth":490,"depth":490,"links":491},"",2,[492,497],{"id":37,"depth":490,"text":38,"children":493},[494,496],{"id":42,"depth":495,"text":45},3,{"id":62,"depth":495,"text":65},{"id":71,"depth":490,"text":72,"children":498},[499,500,501,502,503,504,505,506,507,508,509,510,511,512,513,514,515,516,517,518,519,520,521,522,523],{"id":75,"depth":495,"text":78},{"id":84,"depth":495,"text":87},{"id":97,"depth":495,"text":100},{"id":108,"depth":495,"text":111},{"id":120,"depth":495,"text":123},{"id":129,"depth":495,"text":132},{"id":148,"depth":495,"text":151},{"id":172,"depth":495,"text":175},{"id":184,"depth":495,"text":168},{"id":198,"depth":495,"text":201},{"id":214,"depth":495,"text":210},{"id":225,"depth":495,"text":228},{"id":240,"depth":495,"text":243},{"id":259,"depth":495,"text":262},{"id":282,"depth":495,"text":285},{"id":291,"depth":495,"text":294},{"id":300,"depth":495,"text":303},{"id":309,"depth":495,"text":312},{"id":340,"depth":495,"text":343},{"id":374,"depth":495,"text":377},{"id":396,"depth":495,"text":399},{"id":417,"depth":495,"text":420},{"id":447,"depth":495,"text":450},{"id":459,"depth":495,"text":462},{"id":474,"depth":495,"text":477},"md",{},true,"\u002Fdocs\u002Fcli\u002Frun",{"title":5,"description":489},"docs\u002Fcli\u002Frun","aa4QwzDogIqy_ySO2P3w2CHvG2p3MnhebfNp2pZotCg",[532,535,538,541,544,547,550,553,556,559,562,565,568,571,574,577,580,583,586,589,592,595,598,601,604,607,610,613,616,619,622,625,628,631,634,637,640,643,646,649,652,655,658,661,664,667,670,673,676,679,682,685,688,691,694,697,700,703,706,709,712,715,718,721,724,727,730,733,736,739,740,743,746,749,752,755,758,761,764,767,770,773,776,779,782,785,788,791,794,797,800,803,806,809,812,815,818,821,824,827,830,833,836,839,842,845,848,851,854,857,860,863,866,869,872,875],{"path":533,"title":534},"\u002Fdocs\u002Fbenchmarks","Benchmarks",{"path":536,"title":537},"\u002Fdocs\u002Fbun-users","For bun users",{"path":539,"title":540},"\u002Fdocs\u002Fcli\u002Fadd","scpm add",{"path":542,"title":543},"\u002Fdocs\u002Fcli\u002Fapprove-builds","scpm approve-builds",{"path":545,"title":546},"\u002Fdocs\u002Fcli\u002Faudit","scpm audit",{"path":548,"title":549},"\u002Fdocs\u002Fcli\u002Fbin","scpm bin",{"path":551,"title":552},"\u002Fdocs\u002Fcli\u002Fcache","scpm cache",{"path":554,"title":555},"\u002Fdocs\u002Fcli\u002Fcache\u002Fdelete","scpm cache delete",{"path":557,"title":558},"\u002Fdocs\u002Fcli\u002Fcache\u002Flist","scpm cache list",{"path":560,"title":561},"\u002Fdocs\u002Fcli\u002Fcache\u002Flist-registries","scpm cache list-registries",{"path":563,"title":564},"\u002Fdocs\u002Fcli\u002Fcache\u002Fprune","scpm cache prune",{"path":566,"title":567},"\u002Fdocs\u002Fcli\u002Fcache\u002Fview","scpm cache view",{"path":569,"title":570},"\u002Fdocs\u002Fcli\u002Fcat-file","scpm cat-file",{"path":572,"title":573},"\u002Fdocs\u002Fcli\u002Fcat-index","scpm cat-index",{"path":575,"title":576},"\u002Fdocs\u002Fcli\u002Fcheck","scpm check",{"path":578,"title":579},"\u002Fdocs\u002Fcli\u002Fci","scpm ci",{"path":581,"title":582},"\u002Fdocs\u002Fcli\u002Fclean","scpm clean",{"path":584,"title":585},"\u002Fdocs\u002Fcli\u002Fcompletion","scpm completion",{"path":587,"title":588},"\u002Fdocs\u002Fcli\u002Fconfig","scpm config",{"path":590,"title":591},"\u002Fdocs\u002Fcli\u002Fconfig\u002Fdelete","scpm config delete",{"path":593,"title":594},"\u002Fdocs\u002Fcli\u002Fconfig\u002Fexplain","scpm config explain",{"path":596,"title":597},"\u002Fdocs\u002Fcli\u002Fconfig\u002Ffind","scpm config find",{"path":599,"title":600},"\u002Fdocs\u002Fcli\u002Fconfig\u002Fget","scpm config get",{"path":602,"title":603},"\u002Fdocs\u002Fcli\u002Fconfig\u002Flist","scpm config list",{"path":605,"title":606},"\u002Fdocs\u002Fcli\u002Fconfig\u002Fset","scpm config set",{"path":608,"title":609},"\u002Fdocs\u002Fcli\u002Fconfig\u002Ftui","scpm config tui",{"path":611,"title":612},"\u002Fdocs\u002Fcli\u002Fcreate","scpm create",{"path":614,"title":615},"\u002Fdocs\u002Fcli\u002Fdedupe","scpm dedupe",{"path":617,"title":618},"\u002Fdocs\u002Fcli\u002Fdeploy","scpm deploy",{"path":620,"title":621},"\u002Fdocs\u002Fcli\u002Fdeprecate","scpm deprecate",{"path":623,"title":624},"\u002Fdocs\u002Fcli\u002Fdeprecations","scpm deprecations",{"path":626,"title":627},"\u002Fdocs\u002Fcli\u002Fdiag","scpm diag",{"path":629,"title":630},"\u002Fdocs\u002Fcli\u002Fdiag\u002Fanalyze","scpm diag analyze",{"path":632,"title":633},"\u002Fdocs\u002Fcli\u002Fdiag\u002Fcompare","scpm diag compare",{"path":635,"title":636},"\u002Fdocs\u002Fcli\u002Fdist-tag","scpm dist-tag",{"path":638,"title":639},"\u002Fdocs\u002Fcli\u002Fdist-tag\u002Fadd","scpm dist-tag add",{"path":641,"title":642},"\u002Fdocs\u002Fcli\u002Fdist-tag\u002Fls","scpm dist-tag ls",{"path":644,"title":645},"\u002Fdocs\u002Fcli\u002Fdist-tag\u002Frm","scpm dist-tag rm",{"path":647,"title":648},"\u002Fdocs\u002Fcli\u002Fdlx","scpm dlx",{"path":650,"title":651},"\u002Fdocs\u002Fcli\u002Fdoctor","scpm doctor",{"path":653,"title":654},"\u002Fdocs\u002Fcli\u002Fexec","scpm exec",{"path":656,"title":657},"\u002Fdocs\u002Fcli\u002Ffetch","scpm fetch",{"path":659,"title":660},"\u002Fdocs\u002Fcli\u002Ffind-hash","scpm find-hash",{"path":662,"title":663},"\u002Fdocs\u002Fcli\u002Fignored-builds","scpm ignored-builds",{"path":665,"title":666},"\u002Fdocs\u002Fcli\u002Fimport","scpm import",{"path":668,"title":669},"\u002Fdocs\u002Fcli","scpm",{"path":671,"title":672},"\u002Fdocs\u002Fcli\u002Finit","scpm init",{"path":674,"title":675},"\u002Fdocs\u002Fcli\u002Finstall","scpm install",{"path":677,"title":678},"\u002Fdocs\u002Fcli\u002Flicenses","scpm licenses",{"path":680,"title":681},"\u002Fdocs\u002Fcli\u002Flink","scpm link",{"path":683,"title":684},"\u002Fdocs\u002Fcli\u002Flist","scpm list",{"path":686,"title":687},"\u002Fdocs\u002Fcli\u002Flogin","scpm login",{"path":689,"title":690},"\u002Fdocs\u002Fcli\u002Flogout","scpm logout",{"path":692,"title":693},"\u002Fdocs\u002Fcli\u002Foutdated","scpm outdated",{"path":695,"title":696},"\u002Fdocs\u002Fcli\u002Fpack","scpm pack",{"path":698,"title":699},"\u002Fdocs\u002Fcli\u002Fpatch","scpm patch",{"path":701,"title":702},"\u002Fdocs\u002Fcli\u002Fpatch-commit","scpm patch-commit",{"path":704,"title":705},"\u002Fdocs\u002Fcli\u002Fpatch-remove","scpm patch-remove",{"path":707,"title":708},"\u002Fdocs\u002Fcli\u002Fpeers","scpm peers",{"path":710,"title":711},"\u002Fdocs\u002Fcli\u002Fpeers\u002Fcheck","scpm peers check",{"path":713,"title":714},"\u002Fdocs\u002Fcli\u002Fprune","scpm prune",{"path":716,"title":717},"\u002Fdocs\u002Fcli\u002Fpublish","scpm publish",{"path":719,"title":720},"\u002Fdocs\u002Fcli\u002Fpurge","scpm purge",{"path":722,"title":723},"\u002Fdocs\u002Fcli\u002Fquery","scpm query",{"path":725,"title":726},"\u002Fdocs\u002Fcli\u002Frebuild","scpm rebuild",{"path":728,"title":729},"\u002Fdocs\u002Fcli\u002Frecursive","scpm recursive",{"path":731,"title":732},"\u002Fdocs\u002Fcli\u002Fremove","scpm remove",{"path":734,"title":735},"\u002Fdocs\u002Fcli\u002Frestart","scpm restart",{"path":737,"title":738},"\u002Fdocs\u002Fcli\u002Froot","scpm root",{"path":527,"title":5},{"path":741,"title":742},"\u002Fdocs\u002Fcli\u002Fsbom","scpm sbom",{"path":744,"title":745},"\u002Fdocs\u002Fcli\u002Fsponsors","scpm sponsors",{"path":747,"title":748},"\u002Fdocs\u002Fcli\u002Fstage","scpm stage",{"path":750,"title":751},"\u002Fdocs\u002Fcli\u002Fstart","scpm start",{"path":753,"title":754},"\u002Fdocs\u002Fcli\u002Fstop","scpm stop",{"path":756,"title":757},"\u002Fdocs\u002Fcli\u002Fstore","scpm store",{"path":759,"title":760},"\u002Fdocs\u002Fcli\u002Fstore\u002Fadd","scpm store add",{"path":762,"title":763},"\u002Fdocs\u002Fcli\u002Fstore\u002Fpath","scpm store path",{"path":765,"title":766},"\u002Fdocs\u002Fcli\u002Fstore\u002Fprune","scpm store prune",{"path":768,"title":769},"\u002Fdocs\u002Fcli\u002Fstore\u002Fstatus","scpm store status",{"path":771,"title":772},"\u002Fdocs\u002Fcli\u002Ftest","scpm test",{"path":774,"title":775},"\u002Fdocs\u002Fcli\u002Fundeprecate","scpm undeprecate",{"path":777,"title":778},"\u002Fdocs\u002Fcli\u002Funlink","scpm unlink",{"path":780,"title":781},"\u002Fdocs\u002Fcli\u002Funpublish","scpm unpublish",{"path":783,"title":784},"\u002Fdocs\u002Fcli\u002Fupdate","scpm update",{"path":786,"title":787},"\u002Fdocs\u002Fcli\u002Fversion","scpm version",{"path":789,"title":790},"\u002Fdocs\u002Fcli\u002Fview","scpm view",{"path":792,"title":793},"\u002Fdocs\u002Fcli\u002Fwhy","scpm why",{"path":795,"title":796},"\u002Fdocs\u002Ferror-codes","Error and warning codes",{"path":798,"title":799},"\u002Fdocs\u002Fgetting-started","Getting Started",{"path":801,"title":802},"\u002Fdocs\u002Fguide","Guide",{"path":804,"title":805},"\u002Fdocs","SCPM Documentation",{"path":807,"title":808},"\u002Fdocs\u002Finstallation","Installation",{"path":810,"title":811},"\u002Fdocs\u002Fnpm-users","For npm users",{"path":813,"title":814},"\u002Fdocs\u002Fpackage-manager\u002Fconfiguration","Configuration",{"path":816,"title":817},"\u002Fdocs\u002Fpackage-manager\u002Fdependencies","Manage dependencies",{"path":819,"title":820},"\u002Fdocs\u002Fpackage-manager\u002Fglobal-virtual-store","Global virtual store",{"path":822,"title":823},"\u002Fdocs\u002Fpackage-manager\u002Finstall","Install dependencies",{"path":825,"title":826},"\u002Fdocs\u002Fpackage-manager\u002Fjailed-builds","Jailed dependency builds",{"path":828,"title":829},"\u002Fdocs\u002Fpackage-manager\u002Flifecycle-scripts","Lifecycle scripts",{"path":831,"title":832},"\u002Fdocs\u002Fpackage-manager\u002Flockfiles","Lockfiles",{"path":834,"title":835},"\u002Fdocs\u002Fpackage-manager\u002Fnode-modules","node_modules layout",{"path":837,"title":838},"\u002Fdocs\u002Fpackage-manager\u002Fpublishing","Publishing",{"path":840,"title":841},"\u002Fdocs\u002Fpackage-manager\u002Fregistry-auth","Registry and auth",{"path":843,"title":844},"\u002Fdocs\u002Fpackage-manager\u002Fscripts","Run scripts and binaries",{"path":846,"title":847},"\u002Fdocs\u002Fpackage-manager\u002Fsecurity-scanner","Security scanner",{"path":849,"title":850},"\u002Fdocs\u002Fpackage-manager\u002Fworkspaces","Workspaces",{"path":852,"title":853},"\u002Fdocs\u002Fpnpm-users","For pnpm users",{"path":855,"title":856},"\u002Fdocs\u002Fsecurity","Security",{"path":858,"title":859},"\u002Fdocs\u002Fsettings\u002Fcli","CLI Settings",{"path":861,"title":862},"\u002Fdocs\u002Fsettings\u002Fenv","Environment Settings",{"path":864,"title":865},"\u002Fdocs\u002Fsettings","Settings",{"path":867,"title":868},"\u002Fdocs\u002Fsettings\u002Fnpmrc",".npmrc Settings",{"path":870,"title":871},"\u002Fdocs\u002Fsettings\u002Fworkspace-yaml","Workspace YAML Settings",{"path":873,"title":874},"\u002Fdocs\u002Ftroubleshooting","Troubleshooting",{"path":876,"title":877},"\u002Fdocs\u002Fyarn-users","For yarn users",1780584396942]