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

# FaceTime CLI

> Connect your agent to FaceTime without building a webhook receiver.

The Chert CLI is an npm-installed connector that runs alongside your agent. **You write the agent integration; the package handles the receiver.** You do not need to build or expose a public webhook endpoint.

<Note>
  Private preview: the package is supplied by Chert as a reviewed npm tarball. It is not published on the npm registry. Enrollment requires a Chert-enabled pilot. The current CLI supports inbound audio only.
</Note>

## Choose your workflow

| Mode | What it does | Who owns the room? |
| - | - | - |
| **`chert byor` — recommended** | Calls your TypeScript handler to prepare a session and return room credentials. | Your application creates or selects the room and handles cleanup. |
| **`chert create-room` — optional** | Creates a call-scoped LiveKit room and dispatches a compatible named agent when a call arrives. | The connector manages the room and dispatch lifecycle. |

Both modes use Chert's BYOR call path. `create-room` is a specialized adapter; it does not work with every existing LiveKit agent automatically.

## What the package handles

* Authenticated connection to Chert, without a public receiver URL.
* Call decisions, time limits, and duplicate requests.
* Durable call-event delivery and recovery after a restart.
* Project and line enrollment, explicit activation, and diagnostics.

**Your agent still runs as its own process.** The CLI does not start or restart it. In BYOR mode, your application also owns session readiness, credentials, and verified cleanup. The package includes TypeScript callback types; no separate SDK or Docker container is required.

## From install to a call

Install the package → initialize your mode → connect your agent → check readiness → enroll one project and line → activate → receive a test call.

The preview supports one line per enrolled project and one active call per connector. Installing or running the CLI does not activate a line.

<CardGroup cols={2}>
  <Card title="BYOR quickstart" icon="code" href="/facetime-cli/byor">
    Keep your session logic and replace the receiver with callbacks.
  </Card>

  <Card title="Create-room quickstart" icon="video" href="/facetime-cli/create-room">
    Let the connector manage rooms for a compatible LiveKit agent.
  </Card>

  <Card title="Connect your project" icon="link" href="/facetime-cli/connect">
    Enroll and activate your chosen project and line.
  </Card>

  <Card title="Commands" icon="terminal" href="/facetime-cli/commands">
    Common commands, diagnostics, and recovery.
  </Card>
</CardGroup>