Skip to content
ɳSelf Docs

Migration Roadmap

Migration Roadmap

Section titled “Migration Roadmap”

This page covers the full upgrade path across three versions.

v0.9 → v1.1.0

Section titled “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

Section titled “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:

Terminal window
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

Section titled “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

Section titled “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.

Section titled “Related”