Integrations

Using the CLI

The There There CLI lets you manage your tickets and contacts directly from the terminal. List tickets, reply to customers, assign team members, and more, without opening the dashboard.

Beta status

The There There CLI is currently in beta. If you have any feedback or questions, please reach out to us at support@there-there.app.

Installation

Install the CLI globally via Composer:

composer global require spatie/there-there-cli

Make sure Composer's global bin directory is in your PATH. You can find the path with:

composer global config bin-dir --absolute

Verify the installation:

there-there --version

Authentication

To use the CLI, you need an API token. You can create one in your workspace settings under API Tokens.

there-there login

You'll be prompted to paste your API token. The token is stored locally at ~/.there-there/config.json.

To log out and clear your stored credentials:

there-there logout

Available commands

Every There There API endpoint has a corresponding CLI command. Run there-there to see all commands, or there-there <command> --help for details on a specific command.

Tickets

  • list-tickets — List all tickets. Supports filtering by status, channel, tags, and assignment.
  • show-ticket — View a ticket with its full message thread and activity log.
  • update-ticket-status — Change a ticket's status to open, closed, or spam.
  • update-ticket-assignee — Assign or unassign a user from a ticket.
  • update-ticket-team — Assign or unassign a team from a ticket.
  • add-tag-to-ticket / remove-tag-from-ticket — Manage tags on a ticket.
  • list-ticket-activities — View the activity log for a ticket.
there-there list-tickets --filter-status=open --sort=-updated_at

Messages

  • reply-to-ticket — Send a reply to a customer.
  • forward-ticket — Forward a ticket to an external recipient.
  • add-note-to-ticket — Add an internal note visible only to your team.
there-there reply-to-ticket --ticket=ULID --field body="<p>Thanks for reaching out!</p>"

Contacts

  • list-contacts — List contacts with search and filter support.
  • show-contact — View a contact's details.

Workspace

  • get-me — Get the current user and workspace info.
  • list-tags — List all workspace tags.
  • list-channels — List all workspace channels.
  • list-members — List all workspace members.

Filtering and sorting

List commands support filtering and sorting through command options. Filters use --filter- prefixed options, and sorting uses the --sort option. Prefix a sort field with - to sort in descending order.

there-there list-tickets --filter-status=open --filter-assigned-to-me=true --sort=-updated_at

All list commands support pagination with --page and --per-page (maximum 100 items per page).

there-there list-tickets --page=2 --per-page=10

Output options

By default, the CLI displays results in a human readable format. You can switch to structured output for scripting and automation:

  • --json — Output raw JSON.
  • --yaml — Output YAML.
there-there list-tickets --json
there-there list-tickets --json | jq '.data[].subject'

AI agent integration

The There There CLI includes an agent skill that teaches AI coding agents how to use the CLI to manage tickets and support workflows on your behalf.