Agate ships helper tasks for installing development tooling and patching Spotify. Because Agate is an immutable image, these tasks handle the layering and setup steps for you.
Install Nix before Devbox. The agate-devbox task depends on Nix being present on the system.
Nix package manager
The agate-nixpkgs task installs the Nix package manager on top of the immutable Agate base. Nix gives you access to a large package ecosystem that complements RPMs and Flatpaks, covering packages not available through either channel.Install Nix
Reload your shell environment
After installation completes, reload your shell or open a new terminal so the Nix tooling is available on your PATH. Devbox
The agate-devbox task installs Devbox, a Nix-based tool for creating reproducible, per-project development environments. Devbox lets you pin exact tool versions (Node, Python, Go, and more) for each project without touching the system.Devbox is ideal for managing project-specific runtimes. Define a devbox.json in your project root to lock the exact versions of Node, Python, Go, or any other tool your project needs.
Install Devbox
Install Nix first
Devbox requires Nix. If you have not already installed it, run: Run the Devbox installer task
Initialize a project environment
In any project directory, initialize a Devbox environment: Spicetify
The agate-spicetify task patches the Spotify Flatpak and installs Spicetify Marketplace, enabling custom themes and extensions for Spotify.Spotify must be installed as a Flatpak before running this task. Install it from Flathub if you have not already done so.
Install Spicetify
Install Spotify from Flathub
If Spotify is not already installed, add it from Flathub:flatpak install flathub com.spotify.Client
Run the Spicetify task
The task patches the Spotify Flatpak and installs the Spicetify Marketplace in one step. Open Spotify and browse the Marketplace
Launch Spotify. The Spicetify Marketplace will be available in the sidebar, where you can install themes and extensions.
