shappetrack 1.0.6

ShappeTrack CLI — clone, commit, and push ShappeTrack repositories with one app token.

ShappeTrack CLI

Clone, commit, and push ShappeTrack repositories with one app token — the familiar git commands you already know, backed by ShappeTrack.

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.

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. ShappeTrack handles authentication and hosting for you — there's no separate token or server to manage.

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