shappetrack 1.0.2

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      # paste your app token
shappetrack clone my-repo

Install

The recommended way is pipx, which installs the CLI in an isolated environment and puts the shappetrack command on your PATH:

pipx install shappetrack

Or with plain pip:

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:

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

   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