Prompts
Fetch and commit versioned prompts in a project, including tagging commits (e.g. `production`).
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. |