Skip to content

Leechael/mava-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mava-cli

mava-cli is a command-line tool for managing Mava support tickets.

It supports:

  • listing and filtering tickets
  • viewing ticket details and message timelines
  • searching messages by content
  • replying to tickets (including internal notes)
  • assigning tickets to team members (by name, case-insensitive)
  • updating ticket status
  • listing team members dynamically from the API

Install

Option A: Download from GitHub Releases

gh release list -R Leechael/mava-cli
TAG="vX.Y.Z"
gh release download "$TAG" -R Leechael/mava-cli --pattern "mava-cli-*.tar.gz"

Extract the archive for your platform and place mava-cli in your PATH.

Option B: Build from source

git clone git@github.com:Leechael/mava-cli.git
cd mava-cli
make build
# binary is at bin/mava-cli

Configuration

Set your Mava auth token via environment variable:

export MAVA_TOKEN="<your-jwt-token>"

To obtain a token, log in to dashboard.mava.app, open browser DevTools, and copy the x-auth-token cookie value.


Commands

Ticket management

  • mava-cli list — list tickets with filters (status, priority, source, assigned-to, etc.)
  • mava-cli list --todo — show tickets that need a human reply
  • mava-cli get <ticket-id> — view ticket details and message timeline
  • mava-cli search <query> — search messages by content
  • mava-cli reply <ticket-id> [message] — reply to a ticket (reads from stdin if message omitted)
  • mava-cli reply <ticket-id> --internal [message] — send an internal note
  • mava-cli update-status <ticket-id> <status> — update ticket status (Open, Pending, Waiting, Resolved, Spam)
  • mava-cli assign <ticket-id> <agent> — assign ticket to an agent by name or ID

Team

  • mava-cli list-members — list all team members
  • mava-cli list-members --include-archived — include archived members
  • mava-cli list-members --json — output as JSON

Output modes

  • Default output is human-readable plain text
  • --json — parseable JSON output
  • --jq <filter> — apply jq filter to JSON output (on list, get, search)

Usage examples

# list open tickets
mava-cli list --status Open

# list tickets assigned to you that need reply
mava-cli list --todo

# view a ticket
mava-cli get 69a5592c9927182b6142cff2

# search for messages
mava-cli search "API key"

# reply to a ticket
mava-cli reply 69a5592c9927182b6142cff2 "Thanks for reaching out!"

# reply from stdin (pipe in a file, editor output, etc.)
cat response.md | mava-cli reply 69a5592c9927182b6142cff2

# send internal note
mava-cli reply 69a5592c9927182b6142cff2 --internal "Escalating to eng team"

# assign ticket (case-insensitive name matching)
mava-cli assign 69a5592c9927182b6142cff2 paco
mava-cli assign 69a5592c9927182b6142cff2 Hugo

# update status
mava-cli update-status 69a5592c9927182b6142cff2 Resolved

# list team members
mava-cli list-members

# JSON output with jq
mava-cli list --json --jq '.tickets[0].customer'
mava-cli get 69a5592c9927182b6142cff2 --json --jq '.messages | length'

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors