Metadata-Version: 2.4
Name: shappetrack
Version: 1.0.2
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<1.0,>=0.26
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      # paste your app token
shappetrack clone my-repo
```

## Install

The recommended way is [`pipx`](https://pipx.pypa.io/), which installs the CLI in
an isolated environment and puts the `shappetrack` command on your PATH:

```bash
pipx install shappetrack
```

Or with plain pip:

```bash
pip install shappetrack
```

> If `shappetrack` isn't found after `pip install`, its folder isn't on your PATH —
> either use `pipx` (recommended, handles PATH), add Python's Scripts dir to PATH,
> or run it as `python -m shappetrack ...`.

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
   ```
   It points at `https://track-api.shappe.ai` by default; paste your `shp_` token
   when prompted. (For a local dev server: `shappetrack login --server http://127.0.0.1:8000`.)

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
```
