spatie / there-there-cli
A standalone CLI tool for the There There helpdesk.
Requires
- php: ^8.4
Requires (Dev)
- illuminate/http: ^12.53
- laravel-zero/framework: ^12.0.2
- laravel/pint: ^1.25.1
- mockery/mockery: ^1.6.12
- pestphp/pest: ^3.8.4|^4.1.2
- spatie/laravel-openapi-cli: ^1.0
README
A command-line tool for There There, interact with the There There API from your terminal.
Full documentation is available at there-there.com.
Installation
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
Updating
composer global require spatie/there-there-cli
Usage
Authentication
# Log in (automatically creates a profile named after your workspace) there-there login # Log in with a specific profile name there-there login --profile=spatie # Log out the active profile there-there logout # Log out a specific profile there-there logout --profile=spatie
Get your API token at there-there.app.
Profiles
If you have multiple workspaces, you can store credentials for each one in a separate profile.
# Log in to your first workspace there-there login --profile=spatie # Log in to your second workspace there-there login --profile=ohdear # List all profiles there-there profiles # Switch the default profile there-there use spatie # Run a single command against a different profile there-there list-tickets --profile=ohdear
Commands
Every There There API endpoint has a corresponding command. Run there-there <command> --help for details on a specific command.
there-there list-tickets there-there list-tickets --q="refund request" there-there list-tickets --filter-search="billing" there-there list-tickets --filter-created-after=2026-01-01 there-there show-ticket --ticket-id=<id> there-there reply-to-ticket --ticket-id=<id> --field body="Your reply here" there-there forward-ticket --ticket-id=<id> --field to="email@example.com" there-there add-note-to-ticket --ticket-id=<id> --field body="Internal note" there-there update-ticket-status --ticket-id=<id> --field status=closed there-there update-ticket-assignee --ticket-id=<id> --field member_id=<member-id> there-there update-ticket-team --ticket-id=<id> --field team_id=<team-id> there-there add-tag-to-ticket --ticket-id=<id> --field tag_id=<tag-id> there-there remove-tag-from-ticket --ticket-id=<id> --tag-id=<tag-id> there-there list-ticket-activities --ticket-id=<id> there-there list-contacts there-there show-contact --contact-id=<id> there-there list-channels there-there list-members there-there list-tags there-there get-me
Agent Skill
This repository includes an agent skill that teaches coding agents how to use the There There CLI.
Install
there-there install-skill
Testing
composer test
Releasing a new version
-
Build the PHAR:
php there-there app:build there-there --build-version=1.x.x
-
Commit and push:
git add builds/there-there git commit -m "Release v1.x.x" git push origin main -
Create a release in the GitHub UI.
Users update with composer global require spatie/there-there-cli.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.