Migration Roadmap

Migration Roadmap

This page covers the full upgrade path across three versions.

---

v0.9 → v1.1.0

See the Upgrade from v0.9 guide for the full path.

Key changes:

• CLI is now a single Go binary. Install via brew install nself-org/tap/nself.
• Plugin system redesigned. Re-install all plugins after upgrade.
• All v0.9 env vars still accepted (will be deprecated in a future release).

---

v1.0.8 → v1.1.0

See the v1.0.8 to v1.1.0 migration guide for the full signal table.

Non-breaking release. Quick upgrade:

brew upgrade nself
nself version
nself doctor

Notable signals:

• Bundle renamed: nMedia → nself. Re-install: �P1� plugin install nTV.
• Plugin SDK Go module path changed (plugin authors only).
• Hasura nself deprecated: EOL 2027-04-17.

---

v1.1.0 → future

v1.1.0 is the current release. No removal signals are planned for the next minor version. Any future deprecations follow the 3-phase deprecation cycle: at least one minor version of warnings before removal.

---

Deprecation policy

ɳSelf uses a 3-phase cycle for all deprecations:

1. Phase 1: Warning (1 minor version): item still works, warning on every invocation.
2. Phase 2: Deprecated (1 minor version): stronger warning, removal date communicated.
3. Phase 3: Removed: item gone, clear error with migration link.

Security vulnerabilities may skip phases. All other removals go through the full cycle.

---

Related

• Upgrade from v0.9
• v1.0.8 to v1.1.0
• Changelog