Metadata-Version: 2.4
Name: fork3
Version: 0.2.1
Summary: Manage parallel branch workspaces around git repositories
Project-URL: Homepage, https://github.com/chengyanru/fork3
Project-URL: Repository, https://github.com/chengyanru/fork3
Project-URL: Issues, https://github.com/chengyanru/fork3/issues
Author-email: Cheng Yanru <yanru@cyanru.com>
License-Expression: CC-BY-NC-ND-4.0
License-File: LICENSE
Keywords: branch,cli,git,workspace
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: tomli-w
Description-Content-Type: text/markdown

# fork3

Manage parallel branch workspaces around git repositories.

## Installation

```bash
pip install fork3
```

Or with [pipx](https://pipx.pypa.io/) for isolated CLI installs:

```bash
pipx install fork3
```

Or with [uv](https://docs.astral.sh/uv/):

```bash
uv pip install fork3
```

## Usage

```bash
fork3 create   # Create parallel branch workspaces
fork3 status   # Show workspace status
fork3 sync     # Sync workspaces with remote
fork3 push     # Push workspace branches
```

Run `fork3 --help` for full usage details.

## Documentation

- [`docs/prd/`](docs/prd/prd-260418-fork3/index.md) — Product requirements (CLI behavior, workspace model, idempotency rules)
- [`docs/tech/`](docs/tech/execution-plan.md) — Technical design (execution plan, testing strategy, gap analysis)
- [`docs/tech/tech-260419-fork3-standalone.md`](docs/tech/tech-260419-fork3-standalone.md) — Standalone extraction design

> `installation-integration.md` is superseded — fork3 is now distributed via PyPI, not the monorepo `install.sh` system.

## Requirements

- Python >= 3.11
- Git

## License

[CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/)
