Updates

How to update Ninja and installed shurikens.

Updating Ninja

Via GUI

The GUI updater checks for new releases and provides installation prompts.

Manual Installation

1. Download the latest release from GitHub
2. Install the platform-specific package:

Linux:

# AppImage
chmod +x Ninja-*.AppImage
./Ninja-*.AppImage

# Or tarball
tar -xzf shurikenctl-*.tar.gz
sudo mv shurikenctl /usr/local/bin/

Windows: Run the installer .exe

macOS: Install the .dmg

Build from Source

git pull origin main
cargo build --release
sudo cp target/release/shurikenctl /usr/local/bin/

Updating Shurikens

Upgrade Process

Install a newer .shuriken package with the same ID:

# Via CLI
shurikenctl install path/to/package-v2.0.0.shuriken

# Via GUI
# Use "Install local file" and select the new package

The manager validates metadata and replaces existing files.

Backup Before Upgrade

Create backup:

# Backup shuriken state and project files
# (Backup commands vary by shuriken implementation)

Restore if needed:

# Restore from backup
# (Restore commands vary by shuriken implementation)

Creating Release Packages

Package your shuriken for distribution:

shurikenctl forge

This creates a signed .shuriken package in ~/.ninja/blacksmith/.

Package Contents

• CBOR metadata (name, ID, version, platform)
• tar.gz archive of files
• SHA-256 signature for verification

Verification

Ninja automatically verifies:

1. Magic bytes (HSRZEG)
2. Metadata structure (CBOR)
3. Archive integrity (SHA-256)

If verification fails, installation is aborted.

Version Management

Check installed versions:

shurikenctl list

Rollback by uninstalling and reinstalling an older package:

shurikenctl remove {name}
shurikenctl install path/to/old-version.shuriken

See also: Armory, CLI Reference