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] <ORGANIZATION_ID> <PROJECT_ID> <PROMPT_NAME> <PROMPT>Arguments
| Name | Required |
|---|---|
ORGANIZATION_ID | yes |
PROJECT_ID | yes |
PROMPT_NAME | yes |
PROMPT | yes |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--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] <ORGANIZATION_ID> <PROJECT_ID> <PROMPT_NAME>Arguments
| Name | Required |
|---|---|
ORGANIZATION_ID | yes |
PROJECT_ID | yes |
PROMPT_NAME | yes |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--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] <ORGANIZATION_ID> <PROJECT_ID>Arguments
| Name | Required |
|---|---|
ORGANIZATION_ID | yes |
PROJECT_ID | yes |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
-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] <ORGANIZATION_ID> <PROJECT_ID> <PROMPT_NAME> <COMMIT_ID>Arguments
| Name | Required |
|---|---|
ORGANIZATION_ID | yes |
PROJECT_ID | yes |
PROMPT_NAME | yes |
COMMIT_ID | yes |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--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] <ORGANIZATION_ID> <PROJECT_ID> <PROMPT_NAME>Arguments
| Name | Required |
|---|---|
ORGANIZATION_ID | yes |
PROJECT_ID | yes |
PROMPT_NAME | yes |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--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] <ORGANIZATION_ID> <PROJECT_ID> <PROMPT_NAME>Arguments
| Name | Required |
|---|---|
ORGANIZATION_ID | yes |
PROJECT_ID | yes |
PROMPT_NAME | yes |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
-o, --output | yaml, json | no | Output format. |