# pw ai chats new

> Source: https://parallelworks.com/docs/cli/pw/ai/chats/new

## pw ai chats new

Start a new AI chat

### Synopsis

The **pw ai chats new** command starts a new chat with an AI model.

If no model is specified, you will be prompted to select one interactively.
In non-interactive mode (with --prompt), a model must be specified.

```
pw ai chats new [model] [flags]
```

### Examples

```
  # Interactive chat (select model interactively)
  pw ai chats new
  
  # Interactive chat with a specific model
  pw ai chats new owner:provider/model-name
  
  # Single prompt (non-interactive, model required)
  pw ai chats new -p "What is Go?" owner:provider/model-name
  
  # Use an org provider with a budget allocation
  pw ai chats new --allocation my-alloc org:provider/model-name
  
  # Non-interactive with org provider (allocation required)
  pw ai chats new --allocation my-alloc -p "Hello" org:provider/model-name
```

### Options

```
      --allocation string   Budget allocation name (required for org provider models)
  -h, --help                help for new
  -p, --prompt string       Send a single prompt and exit
      --save                Persist the chat (only for non-interactive mode with --prompt)
```

### Options inherited from parent commands

```
      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Will override any other platform host settings.
  -v, --verbose                Enable verbose logging
```

### SEE ALSO

* [pw ai chats](/docs/cli/pw/ai/chats)	 - Manage AI chats