jadpo ai

Show prompts, record, usage.

show prints what a prompt sends a model (area 21): its type, its file and its version, the first 8 hex characters of a SHA-256 over its two files, then the instructions as the system message, the conversation's turns, and the request as the user message. Placeholders are shown as the prompt's file writes them, each free-text one inside the tagged data block it is sent in. record asks the configured model the prompt once, with the values of its last jadpo dev call or a fixture's, and keeps the answer beside it as recordings//.json for a test's recorded(""), its plain values placeholders; never through a live connection. usage shows the tokens the app's calls used today and this month (UTC) and their estimated cost, by prompt and model, against the daily limit, from the counts ai: { limits: } keeps; never a prompt or an answer. Its database is the one its store's connection's setting gives, or a running jadpo dev's, or the one --url names.

jadpo ai <action> [prompt]

Arguments

• action: What to do: show, record or usage
• prompt (optional): The prompt's name, such as summarise_ticket

Flags

• --as <name>: For record: the recording's name
• --fixture <fixture>: For record: a fixture to ask with
• --url <url>: For usage: the database it reads

On every command

• --json: Print data for tools instead of text
• --full: Show everything a report shortens
• --help: Show every flag, with examples
• --color <when>: Choose when to use colour

jadpo ai --json writes one JSON document to standard output instead of text, with the same exit code. The document has schemaVersion, command ("ai"), ok, data (what the command produced, null when it failed) and diagnostics (each error with its rule, reason, next and help). A command that needs a terminal refuses --json and names the flags that do the same job.

Examples

# See what the summarise_ticket prompt sendsjadpo ai show summarise_ticket# Print it as data for toolsjadpo ai show summarise_ticket --json# Record the model's answer to the last jadpo dev calljadpo ai record summarise_ticket --as long_thread# See the tokens and cost models used today and this monthjadpo ai usage

Errors

• cli.ai_arguments: A jadpo ai command names no action, one it doesn't have, or a prompt the project doesn't declare
• ai.usage_unavailable: The app's AI usage couldn't be read from its database, because it can't be reached or has no table for it yet
• recording.failed: A recording by jadpo package record or jadpo ai record got no answer worth keeping from the sandbox or the model, or its call couldn't be made
• recording.refused: A recording was refused before anything was sent, because its connection would call a live API or has nothing set for its sandbox, its package is installed, or there is nothing to ask its prompt with
• toolchain.project_not_found: You ran a command that works on a project in a folder with no app.jadpo, in it or in any folder above it