Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

slimtree

slimtree makes git worktrees that take little disk. On macOS it clones the files of an existing worktree of the repository with APFS clones, which share their blocks with the originals until either side changes a file. Git sees an ordinary worktree, so git status, commits and branches work as they do after git worktree add.

Alpha. This is slimtree's first release. Commands, flags and output may change in any release before 1.0.

What works in this release

Command macOS on Apple silicon Linux on x86_64 or arm64
slimtree new <branch> Makes a worktree from APFS clones Not in this release yet
slimtree rm <worktree> Removes a worktree slimtree made Not in this release yet
slimtree list Lists the worktrees slimtree made Lists the worktrees slimtree made
slimtree doctor Checks what slimtree needs Checks the FUSE setup, and reports that artifactfs worktrees are not in this release yet

Release builds are tested on macOS 26, Ubuntu 24.04 and Alpine Linux. On Linux, slimtree new will make worktrees served from an artifact-fs FUSE mount. That backend is not in this release, so slimtree new exits with an error there and makes nothing.

Install

uv tool install slimtree
slimtree doctor

slimtree doctor checks what slimtree needs on this machine and in the current directory. It installs nothing, and prints the fix for each check that fails.

Use

In a repository whose main worktree is ~/src/app:

cd ~/src/app
slimtree new my-feature    # makes ~/src/app-my-feature on the branch my-feature
slimtree list
slimtree rm app-my-feature

slimtree new clones the main worktree, from any worktree of the repository. It checks out the branch when it exists, and otherwise makes it at --from, else at HEAD. --path puts the worktree elsewhere.

slimtree rm refuses a worktree with changes unless you pass --force. It keeps the worktree's HEAD in a ref under refs/slimtree/archive/ and never deletes a branch. Run slimtree --help for every flag.

Source and license

Source: https://github.com/dsfaccini/artifact-fs. Apache-2.0; see LICENSE.

slimtree is built on dsfaccini/artifact-fs, a fork of cloudflare/artifact-fs. It is not affiliated with or endorsed by Cloudflare.

Metadata

Release files for slimtree 0.1.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for slimtree 0.1.0a1
File Interpreter ABI Platform Actions
slimtree-0.1.0a1-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.musllinux_1_1_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64, Linux musl 1.1+ x86-64 Details for slimtree-0.1.0a1-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.musllinux_1_1_x86_64.whl
slimtree-0.1.0a1-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64, Linux musl 1.1+ ARM64 Details for slimtree-0.1.0a1-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl
slimtree-0.1.0a1-py3-none-macosx_13_0_arm64.whl Python 3 none macOS 13.0+ ARM64 Details for slimtree-0.1.0a1-py3-none-macosx_13_0_arm64.whl

Total release size: 14.5 MB

Release files / slimtree-0.1.0a1-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.musllinux_1_1_x86_64.whl

Download URL slimtree-0.1.0a1-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.musllinux_1_1_x86_64.whl
Size 5.0 MB
Tags Linux glibc 2.17+ x86-64 Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum
How to use checksums
14ce84e42e169ba51f52bb203bbcb4fe88e0452292b2549de52096e4fddbc1ad
BLAKE2b-256 checksum
How to use checksums
64a96d1f059ddca75c76256af4d9bb7248509805e9ea0f01d26743250c251edc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / slimtree-0.1.0a1-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl

Download URL slimtree-0.1.0a1-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl
Size 4.7 MB
Tags Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3
SHA-256 checksum
How to use checksums
f605ed4d5eb712397092b4b3f4dae16c112e66accfc197c7e387443dc395e9f8
BLAKE2b-256 checksum
How to use checksums
313b2d9c080f28ed92a633ee2e650b221780bdf6b0515ebd36a1f1518fefc06e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / slimtree-0.1.0a1-py3-none-macosx_13_0_arm64.whl

Download URL slimtree-0.1.0a1-py3-none-macosx_13_0_arm64.whl
Size 4.8 MB
Tags Python 3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
b8a0bd324ef57fd259dd64cd1738e7234ce8fe8de322b799e78944144b444181
BLAKE2b-256 checksum
How to use checksums
d5e80740e08336e4e5c59a9eba655fd6d2c1a80b25816c042d0174bc5c23a619
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for slimtree 0.1.0a1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 3 files in this release have been uploaded with provenance metadata.

Select from 3 files

Attestation for slimtree-0.1.0a1-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.musllinux_1_1_x86_64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page