judgment prompts
Fetch and commit versioned prompts in a project, including tagging commits (e.g. `production`).
The Judgment CLI is deprecated and no longer under active development. This reference is retained for existing users. See the CLI deprecation notice for supported alternatives.
Fetch and commit versioned prompts in a project, including tagging commits (e.g. production).
Commands
| Command | Description |
|---|---|
prompts commit | Commit a new prompt version. |
prompts get | Fetch a prompt commit. |
prompts list | List prompts in a project. |
prompts tag | Tag a prompt commit. |
prompts untag | Remove tags from a prompt. |
prompts versions | List every commit of a prompt. |
prompts commit
Commit a new prompt version.
Append a new commit to a prompt. If the prompt does not yet exist it is created. Optionally apply tags to the new commit in the same call.
judgment prompts commit [OPTIONS] [[[ORG_ID] PROJECT_ID] PROMPT_NAME PROMPT...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] PROMPT_NAME PROMPT | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
--tags | text | no | Optional tags (e.g. production, staging) to apply to the new commit. Tags move from any previous commit to this one. |
-o, --output | yaml, json | no | Output format. |
prompts get
Fetch a prompt commit.
Fetch a prompt by name. By default returns the latest commit; pass commit_id to pin a specific commit, or tag to resolve a named tag (e.g. production).
judgment prompts get [OPTIONS] [[[ORG_ID] PROJECT_ID] PROMPT_NAME...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] PROMPT_NAME | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
--commit-id | text | no | Specific commit SHA to fetch. Mutually exclusive with tag. When neither is provided the latest commit is returned. |
--tag | text | no | Tag to fetch (e.g. production). Mutually exclusive with commit_id. |
-o, --output | yaml, json | no | Output format. |
prompts list
List prompts in a project.
List every prompt in a project with its latest commit timestamp and total version count.
judgment prompts list [OPTIONS] [[[ORG_ID] PROJECT_ID]...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
-o, --output | table, yaml, json | no | Output format. |
prompts tag
Tag a prompt commit.
Attach one or more tags to a specific commit. Re-tagging moves the tag from any previous commit to the new one.
judgment prompts tag [OPTIONS] [[[ORG_ID] PROJECT_ID] PROMPT_NAME COMMIT_ID...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] PROMPT_NAME COMMIT_ID | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
--tags | text | yes | Tag names to add. Each tag is unique per prompt — re-tagging moves the tag to the new commit. |
-o, --output | yaml, json | no | Output format. |
prompts untag
Remove tags from a prompt.
Remove one or more tags from a prompt. Returns the commit IDs that previously held the removed tags.
judgment prompts untag [OPTIONS] [[[ORG_ID] PROJECT_ID] PROMPT_NAME...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] PROMPT_NAME | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
--tags | text | yes | Tag names to remove from this prompt. |
-o, --output | yaml, json | no | Output format. |
prompts versions
List every commit of a prompt.
List every commit of a prompt in chronological order (newest first), including tags and authoring metadata.
judgment prompts versions [OPTIONS] [[[ORG_ID] PROJECT_ID] PROMPT_NAME...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] PROMPT_NAME | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
-o, --output | yaml, json | no | Output format. |