<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/guides/how-to/installation/upgrade-cli/">
  <id>https://docs.spec-kitty.ai/guides/how-to/installation/upgrade-cli/</id>
  <title>Upgrade the Spec Kitty CLI</title>
  <updated>2026-06-03T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/guides/how-to/installation/upgrade-cli/"/>
  <summary>Upgrade the Spec Kitty CLI to the 4.x release candidate, verify the installed binary, and know when project migrations are still required.</summary>
  <content type="html">&lt;span id=&quot;upgrade-the-spec-kitty-cli&quot;&gt;&lt;/span&gt;
&lt;p&gt;Upgrade the &lt;code dir=&quot;auto&quot;&gt;spec-kitty&lt;/code&gt; binary to a newer release. This page covers the CLI itself only; for upgrading an existing project’s &lt;code dir=&quot;auto&quot;&gt;.kittify/&lt;/code&gt; scaffold to match, see &lt;a href=&quot;/guides/how-to/installation/upgrade-project/&quot;&gt;Upgrade a project&lt;/a&gt;.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Spec Kitty distinguishes &lt;strong&gt;CLI upgrades&lt;/strong&gt; (installing a new &lt;code dir=&quot;auto&quot;&gt;spec-kitty-cli&lt;/code&gt; wheel) from &lt;strong&gt;project upgrades&lt;/strong&gt; (running migrations inside a project). They are separate steps.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Packagers / forks:&lt;/strong&gt; If you publish Spec Kitty under a different distribution name or private index, do not overlay core sources — register entry-point hooks instead. See &lt;a href=&quot;/guides/how-to/installation/fork-packaging-hooks/&quot;&gt;Fork packaging hooks&lt;/a&gt;.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;quick-reference&quot;&gt;Quick reference&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;4.x is in release candidate.&lt;/strong&gt; Until 4.0.0 is released, a plain install gets the latest stable 3.x release, which has no &lt;code dir=&quot;auto&quot;&gt;consolidate&lt;/code&gt; command. The pre-release flag in each install command on this page (&lt;code dir=&quot;auto&quot;&gt;--pip-args=--pre&lt;/code&gt; for pipx, &lt;code dir=&quot;auto&quot;&gt;--prerelease=allow&lt;/code&gt; for uv, &lt;code dir=&quot;auto&quot;&gt;--pre&lt;/code&gt; for pip) installs the latest 4.x release candidate.&lt;/p&gt;
&lt;/blockquote&gt;





















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Install method&lt;/th&gt;&lt;th&gt;Upgrade command&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;pipx&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;pipx upgrade --pip-args=--pre spec-kitty-cli&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;uv tool&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;uv tool upgrade --prerelease=allow spec-kitty-cli&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;pip (in venv)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;pip install --upgrade --pre spec-kitty-cli&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Let the CLI tell you which one applies:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;upgrade&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--cli&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;This prints the right upgrade command for your detected install method without touching any project state.&lt;/p&gt;
&lt;p&gt;Guidance and preview intent is resolved before hidden agent preference
operations. Hidden &lt;code dir=&quot;auto&quot;&gt;--agent-check&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;--agent-choice&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;--agent-latest&lt;/code&gt;
operations remain standalone; combining them with &lt;code dir=&quot;auto&quot;&gt;--cli&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;--project --json&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;--dry-run&lt;/code&gt;, or &lt;code dir=&quot;auto&quot;&gt;--plan-json&lt;/code&gt; is rejected before preference state can change.
&lt;code dir=&quot;auto&quot;&gt;--plan-json&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;--cli&lt;/code&gt; are mutually exclusive.&lt;/p&gt;
&lt;h2 id=&quot;pipx&quot;&gt;pipx&lt;/h2&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;pipx&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;upgrade&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--pip-args=--pre&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;spec-kitty-cli&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;To force a reinstall (handy after a corrupted upgrade):&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;pipx&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;install&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--force&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--pip-args=--pre&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;spec-kitty-cli&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;To pin a specific version, replace &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;version&gt;&lt;/code&gt; with a released version such as &lt;code dir=&quot;auto&quot;&gt;4.0.0rc8&lt;/code&gt;:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;pipx&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;install&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--force&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;spec-kitty-cli==&amp;#x3C;version&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h2 id=&quot;uv-tool&quot;&gt;uv tool&lt;/h2&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;uv&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;upgrade&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--prerelease=allow&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;spec-kitty-cli&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Or reinstall pinned:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;uv&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;install&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--force&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;spec-kitty-cli==&amp;#x3C;version&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h2 id=&quot;pip-in-a-venv&quot;&gt;pip in a venv&lt;/h2&gt;
&lt;p&gt;Activate the venv first, then:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;pip&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;install&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--upgrade&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--pre&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;spec-kitty-cli&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Or pin a version:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;pip&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;install&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--upgrade&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;spec-kitty-cli==&amp;#x3C;version&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h2 id=&quot;verify-the-upgrade&quot;&gt;Verify the upgrade&lt;/h2&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--version&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# spec-kitty-cli version 4.0.0rc8&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;If &lt;code dir=&quot;auto&quot;&gt;--version&lt;/code&gt; still reports the old number after an upgrade, your shell PATH is picking up a different install. Run &lt;code dir=&quot;auto&quot;&gt;which spec-kitty&lt;/code&gt; (or &lt;code dir=&quot;auto&quot;&gt;where.exe spec-kitty&lt;/code&gt; on Windows) and remove or correct the stale entry.&lt;/p&gt;
&lt;h2 id=&quot;what-happens-after-a-cli-upgrade&quot;&gt;What happens after a CLI upgrade&lt;/h2&gt;
&lt;p&gt;The CLI does not automatically modify any of your projects. When you next run a project command (e.g. &lt;code dir=&quot;auto&quot;&gt;spec-kitty next&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty implement&lt;/code&gt;), spec-kitty checks whether the project schema matches the new CLI:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Compatible&lt;/strong&gt; → command runs normally.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Project needs migration&lt;/strong&gt; → command exits with code 4 and tells you to run &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; in the project root. See &lt;a href=&quot;/guides/how-to/installation/upgrade-project/&quot;&gt;Upgrade a project&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Project too new for this CLI&lt;/strong&gt; → command exits with code 5. You upgraded down, not up; reinstall the newer CLI.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;throttled-upgrade-nag&quot;&gt;Throttled upgrade nag&lt;/h2&gt;
&lt;p&gt;When a newer CLI version is available on PyPI, spec-kitty prints a single banner before normal output. It is throttled to once per 24 hours. Disable per invocation with &lt;code dir=&quot;auto&quot;&gt;--no-nag&lt;/code&gt;, per session with &lt;code dir=&quot;auto&quot;&gt;SPEC_KITTY_NO_NAG=1&lt;/code&gt;, or change the cadence with &lt;code dir=&quot;auto&quot;&gt;SPEC_KITTY_NAG_THROTTLE_SECONDS=&amp;#x3C;seconds&gt;&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;troubleshooting&quot;&gt;Troubleshooting&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;pipx upgrade&lt;/code&gt; says “already at latest” but PyPI has a newer version&lt;/strong&gt; — Your pipx cache is stale. Run &lt;code dir=&quot;auto&quot;&gt;pipx install --force --pip-args=--pre spec-kitty-cli&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;uv tool upgrade&lt;/code&gt; fails with “tool not installed”&lt;/strong&gt; — You installed via pipx, not uv. Use the matching upgrade command for your original install method.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty --version&lt;/code&gt; reports the old version after upgrade&lt;/strong&gt; — &lt;code dir=&quot;auto&quot;&gt;which spec-kitty&lt;/code&gt; will reveal a competing install in another bin directory. Remove the stale one or reorder PATH.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Upgrade succeeded but a command now exits 4 or 5&lt;/strong&gt; — That is the lazy-gate protecting your project; see &lt;a href=&quot;/guides/how-to/installation/upgrade-project/&quot;&gt;Upgrade a project&lt;/a&gt; for the next step.&lt;/p&gt;
&lt;h2 id=&quot;next-steps&quot;&gt;Next steps&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/installation/upgrade-project/&quot;&gt;Upgrade an existing project&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/api/upgrade-lifecycle/&quot;&gt;Upgrade lifecycle reference&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/installation/install-and-upgrade/&quot;&gt;Install and upgrade overview&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/guides/how-to/installation/fork-packaging-hooks/&quot;&gt;Fork packaging hooks&lt;/a&gt; (renamed / private-index distributors)&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
