> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobster.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# mobster chat

> Talk to the built-in agent; follow-ups know what earlier tasks found.

Start or continue a conversation with Mobster's agent on your iPhone. Follow-ups use what earlier tasks found; type while it works to steer it. Uses Mobster for Mac or `mobster serve` when one is open, so approvals show there too. With neither open, a message runs here in the terminal, and `mobster chat` alone opens the terminal UI.

## Usage

```text theme={"theme":"css-variables"}
mobster chat [options] [MESSAGE ...]
```

## Arguments and options

| Name | Default | Description |
| - | - | - |
| `[MESSAGE ...]` | none | what to ask Mobster's agent; leave it out for a conversation in this terminal |
| `--thread ID` | the one this terminal used last | continue this conversation |
| `--new` | off | start a new conversation |
| `--device NAME` | the conversation's | the iPhone or simulator: an id, UDID or name |
| `--json` | off | print one JSON object when the task finishes or needs you; never answers an approval |
| `--keep-waiting` | off | with `--json` and the app or mobster serve running: wait while the task waits for you, until it ends or `--wait` runs out |
| `--wait SECONDS` | 300 | with the app or mobster serve running: how long to follow a task; it goes on after |
| `--url URL` | `$MOBSTER_URL`, else the running Mac app's, else [http://127.0.0.1:8765](http://127.0.0.1:8765) | Mobster's address |
| `--workflow NAME` | none | run a saved workflow (its name or id) instead of a message: in a new conversation, its own one, or `--thread` ID |
| `--set BLANK=VALUE` | none | with `--workflow`: a value for one of its blanks; repeat it for each; repeatable |

`--thread` and `--new` can't be used together.

```text theme={"theme":"css-variables"}
examples:
  mobster chat
  mobster chat "What's on my calendar tomorrow?"
  mobster chat --thread 3f9c2a1b7d0e "Now text Sam the first one"
  mobster chat --workflow "Reels digest" --set topic=basketball
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.