Metadata-Version: 2.4
Name: shappetrack
Version: 1.0.0
Summary: ShappeTrack CLI — clone, commit, and push ShappeTrack repositories with one app token. The git engine stays invisible.
Project-URL: Homepage, https://track.shappe.ai
Author: ShappeTrack
License: Proprietary
Keywords: cli,git,shappetrack,vcs
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.9
Requires-Dist: httpx==0.26.0
Requires-Dist: typer<1.0,>=0.12
Description-Content-Type: text/markdown

# ShappeTrack CLI

Clone, commit, and push ShappeTrack repositories with **one app token**. Real
`git` runs under the hood; the git engine is never exposed.

```
shappetrack login --server https://track-api.shappe.ai/api/v1
shappetrack clone my-repo
```

## Install

The CLI is a small Python package (`shappetrack-cli`). The recommended way is
[`pipx`](https://pipx.pypa.io/), which installs it in an isolated environment so
it never clashes with your other Python tools.

### For end users (once published to PyPI)

```bash
pipx install shappetrack
```

### From source (internal / development)

From the directory containing `pyproject.toml`:

```bash
pipx install .          # isolated, recommended
# or
pip install .           # into the current environment
```

Requires **Python 3.9+** and **git** on your PATH (the CLI runs real git under the hood).

## Usage

1. Create an app token in the web app: **Settings → Access Tokens** (starts with `shp_`).
2. Log in once — this configures git credentials automatically:

   ```bash
   shappetrack login --server https://track-api.shappe.ai/api/v1
   ```

3. Then use the familiar commands (they run standard git underneath):

   ```bash
   shappetrack clone my-repo
   shappetrack status
   shappetrack add .
   shappetrack commit -m "message" --task MT-101
   shappetrack push
   shappetrack pull
   shappetrack branch feature-x
   ```

## How it works

`shappetrack clone my-repo` runs `git clone https://track-api.shappe.ai/repos/my-repo`
using the app token you logged in with. The backend proxies git traffic to the
internal engine — you never see or handle the engine, its host, or its token.

You can also clone with plain git directly (no CLI needed):

```bash
git clone https://track-api.shappe.ai/repos/my-repo
# username: your ShappeTrack username, password: your shp_ app token
```
