jig formatted status by dulaj-me · Pull Request #241 · togethercomputer/together-py

dulaj-me · 2026-02-04T16:29:38Z

E.g:

sprocket-test-dulaj, id: f1ae8348-7379-4c34-9004-6cd273d6d644
status: Ready
min/max replicas: 1/10
desired/ready replicas: 1/1
autoscaling: QueueBacklogPerWorker, target=1.05
created/updated: 2026-02-03 18:51:11 / 2026-02-04 16:25:42

= settings =
registry.together.xyz/proj_csvnq3lka36nwbncbkkva/sprocket-test-dulaj@sha256:d7dae5410dcd838e52625d5417d57b96e5d96bb6061190150d008b81f2aaaaa0
volumes: my-test-volume-2:/app/my-volume
secrets: sprocket-test-dulaj-TOGETHER_API_KEY
gpu: 0x none, cpu: 4, memory: 32GB, storage: 100MB
port: 8000, command: -, args: -, health_check_path: /health
environment: FOO=bar, TOGETHER_API_BASE_URL=https://api.together.xyz, TOGETHER_API_KEY=, TOGETHER_DEPLOYMENT_REVISION_ID=3f3bd767-6629-4cce-a68f-8352b6391c93

= detailed status =
image: bd21ffd14834a1c774593ba8a9475bdb45e1f77072fc48d9b5fd7986b7945d13:
    75dcc8747d-8jq6f: Running, Age 23h, Rev 3f3bd767-6629-4cce-a68f-8352b6391c93 (latest)

… CLI usage (#231)

* move volume mounts to config; remove set/unset * fix import * sort imports * ruff check --fix * no need to unset before delete

…aintain the same order (#234)

* [jig endpoint] fix base url for deployment-request * lint fix

)

narasul · 2026-02-04T16:58:20Z

src/together/lib/cli/api/beta/jig/_utils.py

+            by_image[img].append((replica_name, replica_info))
+
+        for img, replicas in sorted(by_image.items()):
+            lines.append(f"{img}:")


from the example in the description it is not immediately obvious that this is image tag:
Maybe preprent with something like Image -

Fixed. Check description

narasul · 2026-02-04T17:01:01Z

src/together/lib/cli/api/beta/jig/_utils.py

+                status_str = replica_info.get("replica_status", "Unknown")
+                reason = replica_info.get("replica_status_reason")
+                if reason and reason != status_str:
+                    status_str = f"{status_str}:{reason}"


Would be great if we show volume preload status as well. One way to do that is, if there is 'volume_preload_status' and 'volume_preload_completed_at' is empty, show something like Loading volume contents

Fixed. Check description

narasul · 2026-02-04T17:02:24Z

src/together/lib/cli/api/beta/jig/_utils.py

+
+                age = _format_age(replica_info.get("replica_ready_since"))
+
+                lines.append(f"    {replica_name}: {status_str}, Age {age}")


we can show revision_id as well. each replica event will have it(if replica is started). The latest revision id for the whole deployment you can take from environment variables. It is called TOGETHER_DEPLOYMENT_REVISION_ID

Fixed. Check description

narasul · 2026-02-04T19:14:26Z

secrets: sprocket-test-dulaj-TOGETHER_API_KEY

one minor thing, the deployment name can be removed from the secret name, because you do jig secrets set TOGETHER_API_KEY abc not jig secrets set sprocket-test-dulaj-TOGETHER_API_KEY abc

Also if it is a secret it shoudn't be included in the env part like this: TOGETHER_API_KEY=, maybe TOGETHER_API_KEY=[secret] like we do in the UI

technillogue

this should also probably be appropriately capitalized and styled to match, I wrote it out on slack intending it to be the rough content. for comparison:

App
  Name     = pybatch-api
  Owner    = personal
  Hostname = pybatch-api.fly.dev
  Image    = pybatch-api:deployment-01KGJ96CPWZP54PPVH9R6SZD7W

Machines
PROCESS ID              VERSION REGION  STATE   ROLE    CHECKS  LAST UPDATED
app     1850e41f309d38  21      sjc     started                 2026-02-03T17:36:31Z

during deploy:

Machines
PROCESS ID              VERSION REGION  STATE           ROLE    CHECKS  LAST UPDATED
app     1850e41f309d38  22      sjc     replacing                       2026-02-05T04:10:36Z

or `wrangler deployments status`

technillogue · 2026-02-05T03:49:40Z

src/together/lib/cli/api/beta/jig/_utils.py

@@ -0,0 +1,171 @@
+"""Utility functions for jig CLI commands."""


I want to go back to having a single file anyway, this can go in jig.py, but it should be about half the line count

technillogue · 2026-02-05T03:56:34Z

src/together/lib/cli/api/beta/jig/_utils.py

+            # Extract just the tag from image if it's a full path
+            if ":" in img:
+                img = img.split(":")[-1]
+                # Handle digest format (image@sha256:...)


don't think this is correct when someone pushes an image without a tag

technillogue · 2026-02-05T04:03:51Z

src/together/lib/cli/api/beta/jig/_utils.py

+    lines: list[str] = []
+
+    # Header section
+    name = data.get("name", "-")


I guess we could just use the pydantic response object for this

dulaj-me · 2026-02-05T15:26:24Z

Closing this PR and continuing on #249
Stainless messed up this branch history. I cherry picked the commits to the new one

dulaj-me and others added 10 commits February 3, 2026 16:42

docs: Add jig documentation

9bb2454

feat: Improve error handling and messaging when api key is missing in…

cc16ba6

… CLI usage (#231)

fix(jig): replace pprint with click.echo

67281e7

ENG-53061 - ENG-53061 - Move volumes to config (#232)

1dacc2b

* move volume mounts to config; remove set/unset * fix import * sort imports * ruff check --fix * no need to unset before delete

fix(jig): print raw json response for retrieve commands in order to m…

15324d7

…aintain the same order (#234)

[jig endpoint] fix base url for deployment-request (#236)

310a3b5

* [jig endpoint] fix base url for deployment-request * lint fix

scripts/format

fe5adac

fix(jig): fix jig submit response showing request_id and requestId (#240

0518b99

)

feat: ENG-82904 - chore: update ReplicaEvent schema

21d143c

feat(jig): Format jig status

3815764

dulaj-me force-pushed the dulaj/formatted_status branch from 7ceb8db to 3815764 Compare February 4, 2026 16:32

narasul reviewed Feb 4, 2026

View reviewed changes

chore(jig): typing fix

80aa0f2

narasul reviewed Feb 4, 2026

View reviewed changes

chore(jig): minor improvements to status

7dc9e97

stainless-app bot force-pushed the next branch from 3511302 to 450a589 Compare February 4, 2026 19:43

technillogue force-pushed the dulaj/formatted_status branch from 7dc9e97 to eafcf8e Compare February 5, 2026 03:53

technillogue reviewed Feb 5, 2026

View reviewed changes

dulaj-me added 3 commits February 5, 2026 15:06

fix(jig): status formatter use Typed models

23704d6

fix(jig): reformat app status

d12417f

fix(jig): wip: reformat config status

9c76da0

dulaj-me force-pushed the dulaj/formatted_status branch from eafcf8e to 9c76da0 Compare February 5, 2026 15:11

dulaj-me closed this Feb 5, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

jig formatted status#241

jig formatted status#241
dulaj-me wants to merge 15 commits intonextfrom
dulaj/formatted_status

dulaj-me commented Feb 4, 2026 •

edited

Loading

Uh oh!

narasul Feb 4, 2026

Uh oh!

dulaj-me Feb 4, 2026

Uh oh!

narasul Feb 4, 2026

Uh oh!

dulaj-me Feb 4, 2026

Uh oh!

narasul Feb 4, 2026

Uh oh!

dulaj-me Feb 4, 2026

Uh oh!

narasul commented Feb 4, 2026

Uh oh!

technillogue left a comment

Uh oh!

technillogue Feb 5, 2026

Uh oh!

technillogue Feb 5, 2026

Uh oh!

technillogue Feb 5, 2026

Uh oh!

dulaj-me commented Feb 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants


		age = _format_age(replica_info.get("replica_ready_since"))

		lines.append(f" {replica_name}: {status_str}, Age {age}")

		@@ -0,0 +1,171 @@
		"""Utility functions for jig CLI commands."""

Conversation

dulaj-me commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

narasul commented Feb 4, 2026

Uh oh!

technillogue left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dulaj-me commented Feb 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

dulaj-me commented Feb 4, 2026 •

edited

Loading