Metadata-Version: 2.4
Name: remixtree-cli
Version: 0.1.2
Summary: remake scratch's remix tree feature #BringBackRemixTrees
License: MIT
Project-URL: Homepage, https://github.com/Alastrantia/scratch-remixtree
Project-URL: BugTracker, https://github.com/Alastrantia/scratch-remixtree/issues
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp
Requires-Dist: rich
Dynamic: license-file

# scratch-remixtree 🫚

[![PyPI version](https://img.shields.io/pypi/v/remixtree-cli)](https://pypi.org/project/remixtree-cli/)
[![Python](https://img.shields.io/pypi/pyversions/remixtree-cli)](https://pypi.org/project/remixtree-cli/)
[![License](https://img.shields.io/github/license/Alastrantia/scratch-remixtree)](LICENSE)

> A simple CLI to rebuild Scratch’s remix tree feature, which was removed sometime around Mid-October 2025.  
> **#BringBackRemixTrees**

---

## What is this?

Scratch removed the remix tree feature without any warning 😭.  
So, here we go again, in the form of a CLI

This CLI fetches a project’s remixes and builds a tree showing how all the remixes connect, using the official scratch API.

---

## Features

- Async, can create large trees decently fast
- Optional verbose mode to go crazy
- Save the full remix tree to a file if ya want to
- Supports max depth if you wanna show empathy for the Scratch Servers
- Works on Linux, macOS, and Windows (Python 3.10+) (hopefully, if not, tell me)

---

## Installation

### Recommended: using **pipx** (isolated, should-work):
```bash
pip install --user pipx
pipx install remixtree-cli
```
### Alternatively:

```
pip install remixtree-cli
```

## Basic Usage
### Example:
```
remixtree 1223809053 --depth 3 --output tree_output.txt
```
### More options:
```
-h, --help: 
    get a list of flags like this one
-d, --depth:
    specify how deep the tree should go, default is unlimited
-v, --verbose:
    just try it, you'll see for yourself
-o, --ouput:
    probably the most important flag, specify where the tree should be saved
```
