sp

Warning

ALPHA SOFTWARE sp is experimental, under heavy development, and may be unstable. Use at your own risk!

Uninstalling a cask with brew then reinstalling it with sp will have it installed with slightly different paths, your user settings etc. will not be migrated automatically.

sp is a next‑generation, Rust‑powered package manager inspired by Homebrew. It installs and manages:

• Formulae: command‑line tools, libraries, and languages
• Casks: desktop applications and related artifacts on macOS

ARM only for now, might add x86 support eventually

---

⚙️ Project Structure

• sp‑core Core library: fetching, dependency resolution, archive extraction, artifact handling (apps, binaries, pkg installers, fonts, plugins, zap/preflight/uninstall stanzas, etc.)

• sp‑cli Command‑line interface: sp executable wrapping the core library.

---

🚧 Current Status

• Bottle installation and uninstallation
• Cask installation and uninstallation
• Reinstall command for reinstalls
• Upgrade command for updates (very careful. I ran into no system breakers, my Perl install got nuked though)
• Parallel downloads and installs for speed
• Automatic dependency resolution and installation
• Building Formulae from source (very early impl)

---

🚀 Roadmap

• Cleanup old downloads, versions, caches
• Prefix isolation: support /opt/sp as standalone layout
• sp init helper to bootstrap your environment
• Ongoing Bug fixes and stability improvements

---

I know this does not follow one defined style yet. Still thinking about how I actually want it to look so... we'll get there

---

📦 Usage

# Print help
sp --help

# Update metadata
sp update

# Search for packages
sp search <formula/cask>

# Get package info
sp info <formula/cask>

# Install bottles or casks
sp install <formula/cask>

# Build and install a formula from source
sp install --build-from-source <formula>

# Uninstall
sp uninstall <formula/cask>

# Reinstall
sp reinstall <formula/cask>

#Upgrade
sp upgrade <formula/cask> or --all

# (coming soon)
sp cleanup
sp init

---

🏗️ Building from Source

Prerequisites: Rust toolchain (stable).

git clone <repo-url>
cd sp
cargo build --release

The sp binary will be at target/release/sp. Add it to your PATH.

---

📥 Using the Latest Nightly Build

You can download the latest nightly build from actions/workflows/rust.yml inside this repository (select a successful build and scroll down to Artifacts). <--- This link seems to be wrong :(

Before running the downloaded binary, remove the quarantine attribute:

xattr -d com.apple.quarantine ./sp

Then, you can run the binary directly:

./sp --help

---

🤝 Contributing

sp lives and grows by your feedback and code! We’re particularly looking for:

• Testing and bug reports for Cask & Bottle installation + --build-from-source
• Test coverage for core and cask modules
• CLI UI/UX improvements
• See CONTRIBUTING.md

Feel free to open issues or PRs. Every contribution helps!

---

📄 License

• sp: BSD‑3‑Clause - see LICENSE.md
• Inspired by Homebrew BSD‑2‑Clause — see NOTICE.md

---

Alpha software. No guarantees. Use responsibly.