Char
General

CLI Reference

char

Live transcription and audio tools

char [--base-url] [--api-key] [-m] [-l] [--record] [--no-color] [--base] [-v] [-q] [-h] [-V] <command>

Global options:

  • --base-url <BASE_URL>
  • --api-key <API_KEY>
  • -m, --model <MODEL>
  • -l, --language <LANGUAGE> (default: en)
  • --record
  • --no-color
  • --base <DIR>
  • -v, --verbose — Increase logging verbosity
  • -q, --quiet — Decrease logging verbosity

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Subcommands:

  • chat — Interactive chat with an LLM
  • connect — Configure an STT or LLM provider
  • meetings — Browse past meetings
  • humans — Browse humans (contacts)
  • orgs — Browse organizations
  • configure — Configure providers and settings
  • auth — Authenticate with char.com
  • desktop — Open the desktop app or download page
  • bug — Report a bug on GitHub
  • hello — Open char.com
  • transcribe — Transcribe an audio file (no meeting created)
  • models — Manage local models
  • export — Export data in various formats
  • completions — Generate shell completions

char chat

Interactive chat with an LLM

char chat [--prompt] [--provider] [-h] [-V] <command>

Options:

  • --prompt <PROMPT> — Send a single prompt without entering the TUI (use - to read from stdin)
  • --provider <PROVIDER>
  • -h, --help — Print help
  • -V, --version — Print version

Subcommands:

  • resume — Resume an existing chat session

char chat resume

Resume an existing chat session

char chat resume [--meeting] [-h] [-V]

Options:

  • --meeting <MEETING>
  • -h, --help — Print help
  • -V, --version — Print version

char connect

Configure an STT or LLM provider

char connect [--type] [--provider] [-h] [-V]

Options:

  • --type <TYPE>
  • --provider <PROVIDER>
  • -h, --help — Print help
  • -V, --version — Print version

char meetings

Browse past meetings

char meetings [-h] [-V] <command>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Subcommands:

  • new — Start a new meeting
  • view — View a specific meeting
  • participants — List participants in a meeting
  • add-participant — Add a participant to a meeting
  • rm-participant — Remove a participant from a meeting

char meetings new

Start a new meeting

char meetings new [-p] [--audio] [-k] [-h] [-V]

Options:

  • -p, --provider <PROVIDER>
  • --audio <FILE> — Create meeting from an audio file instead of live transcription
  • -k, --keyword <KEYWORD> — Keywords to boost transcription accuracy (with --audio)
  • -h, --help — Print help
  • -V, --version — Print version

char meetings view

View a specific meeting

char meetings view <--id> [-h] [-V]

Options:

  • --id <ID>
  • -h, --help — Print help
  • -V, --version — Print version

char meetings participants

List participants in a meeting

char meetings participants <--id> [-h] [-V]

Options:

  • --id <ID>
  • -h, --help — Print help
  • -V, --version — Print version

char meetings add-participant

Add a participant to a meeting

char meetings add-participant <--meeting> <--human> [-h] [-V]

Options:

  • --meeting <MEETING>
  • --human <HUMAN>
  • -h, --help — Print help
  • -V, --version — Print version

char meetings rm-participant

Remove a participant from a meeting

char meetings rm-participant <--meeting> <--human> [-h] [-V]

Options:

  • --meeting <MEETING>
  • --human <HUMAN>
  • -h, --help — Print help
  • -V, --version — Print version

char humans

Browse humans (contacts)

char humans [-h] [-V] <command>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Subcommands:

  • list — List all humans
  • add — Add a new human
  • edit — Edit a human
  • show — Show details for a human
  • rm — Remove a human

char humans list

List all humans

char humans list [-h] [-V]

Options:

  • -h, --help — Print help
  • -V, --version — Print version

char humans add

Add a new human

char humans add [--email] [--org] [--title] [-h] [-V] <name>

Options:

  • --email <EMAIL>
  • --org <ORG>
  • --title <TITLE>
  • -h, --help — Print help
  • -V, --version — Print version

Arguments:

  • <NAME>

char humans edit

Edit a human

char humans edit <--id> [--name] [--email] [--org] [--title] [--memo] [-h] [-V]

Options:

  • --id <ID>
  • --name <NAME>
  • --email <EMAIL>
  • --org <ORG>
  • --title <TITLE>
  • --memo <MEMO>
  • -h, --help — Print help
  • -V, --version — Print version

char humans show

Show details for a human

char humans show <--id> [-h] [-V]

Options:

  • --id <ID>
  • -h, --help — Print help
  • -V, --version — Print version

char humans rm

Remove a human

char humans rm <--id> [-h] [-V]

Options:

  • --id <ID>
  • -h, --help — Print help
  • -V, --version — Print version

char orgs

Browse organizations

char orgs [-h] [-V] <command>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Subcommands:

  • list — List all organizations
  • add — Add a new organization
  • edit — Edit an organization
  • show — Show details for an organization
  • rm — Remove an organization

char orgs list

List all organizations

char orgs list [-h] [-V]

Options:

  • -h, --help — Print help
  • -V, --version — Print version

char orgs add

Add a new organization

char orgs add [-h] [-V] <name>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Arguments:

  • <NAME>

char orgs edit

Edit an organization

char orgs edit <--id> [--name] [-h] [-V]

Options:

  • --id <ID>
  • --name <NAME>
  • -h, --help — Print help
  • -V, --version — Print version

char orgs show

Show details for an organization

char orgs show <--id> [-h] [-V]

Options:

  • --id <ID>
  • -h, --help — Print help
  • -V, --version — Print version

char orgs rm

Remove an organization

char orgs rm <--id> [-h] [-V]

Options:

  • --id <ID>
  • -h, --help — Print help
  • -V, --version — Print version

char configure

Configure providers and settings

char configure [--tab] [-h] [-V]

Options:

  • --tab <TAB>
  • -h, --help — Print help
  • -V, --version — Print version

char auth

Authenticate with char.com

char auth [-h] [-V]

Options:

  • -h, --help — Print help
  • -V, --version — Print version

char desktop

Open the desktop app or download page

char desktop [-h] [-V]

Options:

  • -h, --help — Print help
  • -V, --version — Print version

char bug

Report a bug on GitHub

char bug [-h] [-V]

Options:

  • -h, --help — Print help
  • -V, --version — Print version

char hello

Open char.com

char hello [-h] [-V]

Options:

  • -h, --help — Print help
  • -V, --version — Print version

char transcribe

Transcribe an audio file (no meeting created)

char transcribe <--input> <-p> [-k] [-o] [-f] [-h] [-V]

Options:

  • --input <FILE>
  • -p, --provider <PROVIDER>
  • -k, --keyword <KEYWORD>
  • -o, --output <FILE>
  • -f, --format <FORMAT> (default: pretty)
  • -h, --help — Print help
  • -V, --version — Print version

char models

Manage local models

char models [-h] [-V] <command>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Subcommands:

  • paths — Show resolved paths for settings and model storage
  • list — List available models and their download status
  • cactus — Manage downloadable Cactus models
  • download — Download a model by name
  • delete — Delete a downloaded model

char models paths

Show resolved paths for settings and model storage

char models paths [-h] [-V]

Options:

  • -h, --help — Print help
  • -V, --version — Print version

char models list

List available models and their download status

char models list [--kind] [--supported] [-f] [-h] [-V]

Options:

  • --kind <KIND>
  • --supported
  • -f, --format <FORMAT> (default: text)
  • -h, --help — Print help
  • -V, --version — Print version

char models cactus

Manage downloadable Cactus models

char models cactus [-h] [-V] <command>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Subcommands:

  • list — List available Cactus models
  • download — Download a Cactus model by name
  • delete — Delete a downloaded Cactus model

char models cactus list

List available Cactus models

char models cactus list [-f] [-h] [-V]

Options:

  • -f, --format <FORMAT> (default: text)
  • -h, --help — Print help
  • -V, --version — Print version

char models cactus download

Download a Cactus model by name

char models cactus download [-h] [-V] <name>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Arguments:

  • <NAME>

char models cactus delete

Delete a downloaded Cactus model

char models cactus delete [-h] [-V] <name>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Arguments:

  • <NAME>

char models download

Download a model by name

char models download [-h] [-V] <name>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Arguments:

  • <NAME>

char models delete

Delete a downloaded model

char models delete [-h] [-V] <name>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Arguments:

  • <NAME>

char export

Export data in various formats

char export [-h] [-V] <command>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Subcommands:

  • meeting — Export a single meeting with all associated data
  • meetings — Export meeting list
  • transcript — Export transcript for a meeting
  • notes — Export notes for a meeting
  • chat — Export chat messages for a meeting
  • humans — Export all contacts
  • orgs — Export all organizations

char export meeting

Export a single meeting with all associated data

char export meeting <--id> [-f] [-o] [-h] [-V]

Options:

  • --id <ID>
  • -f, --format <FORMAT> (default: json)
  • -o, --output <FILE>
  • -h, --help — Print help
  • -V, --version — Print version

char export meetings

Export meeting list

char export meetings [-f] [-o] [-h] [-V]

Options:

  • -f, --format <FORMAT> (default: text)
  • -o, --output <FILE>
  • -h, --help — Print help
  • -V, --version — Print version

char export transcript

Export transcript for a meeting

char export transcript <--meeting> [-f] [-o] [-h] [-V]

Options:

  • --meeting <MEETING>
  • -f, --format <FORMAT> (default: text)
  • -o, --output <FILE>
  • -h, --help — Print help
  • -V, --version — Print version

char export notes

Export notes for a meeting

char export notes <--meeting> [-f] [-o] [-h] [-V]

Options:

  • --meeting <MEETING>
  • -f, --format <FORMAT> (default: markdown)
  • -o, --output <FILE>
  • -h, --help — Print help
  • -V, --version — Print version

char export chat

Export chat messages for a meeting

char export chat <--meeting> [-f] [-o] [-h] [-V]

Options:

  • --meeting <MEETING>
  • -f, --format <FORMAT> (default: markdown)
  • -o, --output <FILE>
  • -h, --help — Print help
  • -V, --version — Print version

char export humans

Export all contacts

char export humans [-f] [-o] [-h] [-V]

Options:

  • -f, --format <FORMAT> (default: text)
  • -o, --output <FILE>
  • -h, --help — Print help
  • -V, --version — Print version

char export orgs

Export all organizations

char export orgs [-f] [-o] [-h] [-V]

Options:

  • -f, --format <FORMAT> (default: text)
  • -o, --output <FILE>
  • -h, --help — Print help
  • -V, --version — Print version

char completions

Generate shell completions

char completions [-h] [-V] <shell>

Options:

  • -h, --help — Print help
  • -V, --version — Print version

Arguments:

  • <SHELL>