shappetrack 1.0.0

ShappeTrack CLI — clone, commit, and push ShappeTrack repositories with one app token. The git engine stays invisible.

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, which installs it in an isolated environment so it never clashes with your other Python tools.

For end users (once published to PyPI)

pipx install shappetrack

From source (internal / development)

From the directory containing pyproject.toml:

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:

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

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

   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):

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