Skip to main content

Prompt Command

The chucky prompt command lets you send prompts to any project in your account directly from the terminal. It supports streaming responses, structured output, and custom tools.

Basic Usage

If you’re in a directory with a .chucky.json file (created by chucky init), the --project flag is optional.

Options

Examples

Simple Prompt

Use a Different Model

Structured JSON Output

Custom System Prompt

Streaming JSON Output

For programmatic use, get each event as JSON:

Auto-Apply Changes

Automatically fetch and apply file changes when the session completes:
This is equivalent to running the prompt, then chucky pull <session-id>. The changes are applied to your working directory and a branch is created for reference.

Reading from Stdin

Pipe content into the prompt:
Or use process substitution:

Output Formats

Text (Default)

Human-readable streaming output with tool calls highlighted:

JSON

Full result object at the end:

Stream JSON

Each message as a separate JSON line (NDJSON):

Using Pre-Generated Tokens

For integration with your backend, you can use a pre-generated JWT token:

Next Steps

Possession Mode

Learn how to let Claude execute commands on your machine