judgment 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.