Installation

Platforms: macOS and Linux. Windows support is planned.

Choose the path that fits your setup.

Recommended: pipx

pipx installs SessionFS in an isolated environment so it never conflicts with other Python packages on your system.

pipx install sessionfs

Upgrade:

pipx upgrade sessionfs

Uninstall:

pipx uninstall sessionfs

Homebrew (macOS)

brew tap sessionfs/tap
brew install sessionfs

Upgrade:

brew upgrade sessionfs

Uninstall:

brew uninstall sessionfs
brew untap sessionfs/tap

Curl installer (all platforms)

A single command that detects the best available install method on your machine (pipx → uv → python3 venv + symlink).

curl -fsSL https://get.sessionfs.dev | sh

Upgrade: re-run the same command — it upgrades in place.

Uninstall:

# If installed via venv path:
rm -rf ~/.sessionfs/venv ~/.local/bin/sfs ~/.local/bin/sfsd

# If installed via pipx:
pipx uninstall sessionfs

# If installed via uv:
uv tool uninstall sessionfs

pip (fallback)

If you already have a Python environment you manage yourself:

pip install sessionfs

Upgrade:

pip install --upgrade sessionfs

Uninstall:

pip uninstall sessionfs

Verify

sfs --version

Next step

sfs init

The wizard auto-detects your installed AI tools, starts the daemon, and walks you through setup in under a minute. See the Quickstart Guide for the full walkthrough.

Telemetry

SessionFS sends anonymous activation telemetry (a random install id, version, OS, and event name — never paths, session content, or personal data). It is easy to disable with SFS_NO_TELEMETRY=1 or [telemetry] enabled = false in ~/.sessionfs/config.toml. See the full Telemetry disclosure for exactly what is sent and how to opt out.