npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@qcobro/ctl

v1.52.2

Published

Command-line tool for QCobro developers, built on @qcobro/sdk.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Maintainers

fonoster-ossfonoster-oss

Keywords

Readme

ctl

Command-Line for QCobro

Version License

Use this tool to manage your QCobro resources from the command line, without going through the operator console: sync a portfolio, create an agent template, or configure an MCP client like Claude Desktop to use @qcobro/mcp.

It's built on @qcobro/sdk, so every command talks to the same QCobro API the SDK and the console use, with the same client-side input validation.

Setup

Link a workspace before running any authenticated command. You'll need a workspace API key (an accessKeyId + accessKeySecret) — create one from the QCobro console's API Keys page — and the accessKeyId of the workspace that key acts in.

$ qcobro workspaces:login

Usage

$ npm install -g @qcobro/ctl
$ qcobro COMMAND
running command...
$ qcobro (--version)
@qcobro/ctl/1.40.1 darwin-arm64 node-v22.17.0
$ qcobro --help [COMMAND]
USAGE
  $ qcobro COMMAND
...

Commands

qcobro agents:create

create an agent template in the active workspace

USAGE
  $ qcobro agents:create --type VOICE_AI|VOICE_PRERECORDED|SMS|EMAIL|WHATSAPP --name <value> [--voice <value>]
    [--language <value>] [--system-prompt <value>] [--first-message <value>] [--script <value>] [--fonoster-app-name
    <value>] [--message-body <value>] [--sender-id <value>] [--subject <value>] [--max-replies <value>] [--template-name
    <value>]

FLAGS
  --first-message=<value>      opening line (VOICE_AI, optional)
  --fonoster-app-name=<value>  Fonoster application name (voice types)
  --language=<value>           language code (voice channel types)
  --max-replies=<value>        reply cap per gestión (EMAIL, WHATSAPP)
  --message-body=<value>       message text (SMS, EMAIL)
  --name=<value>               (required) template name
  --script=<value>             full TTS script (VOICE_PRERECORDED)
  --sender-id=<value>          sender identifier (SMS, optional)
  --subject=<value>            email subject (EMAIL)
  --system-prompt=<value>      AI persona/instructions (VOICE_AI, EMAIL, WHATSAPP)
  --template-name=<value>      Meta template name (WHATSAPP)
  --type=<option>              (required) agent channel type
                               <options: VOICE_AI|VOICE_PRERECORDED|SMS|EMAIL|WHATSAPP>
  --voice=<value>              voice identifier (voice channel types)

DESCRIPTION
  create an agent template in the active workspace

EXAMPLES
  $ qcobro agents:create --type VOICE_AI --name "Cobranza suave" --voice sofia --system-prompt "Sé amable y directo." --language es

  $ qcobro agents:create --type SMS --name "Recordatorio" --message-body "Hola {{firstName}}, tienes un saldo pendiente."

qcobro agents:eval

evaluate a VOICE_AI/EMAIL/WHATSAPP agent's conversation logic — either an existing template plus a scenarios file, or a standalone YAML eval template (agent definition plus its own embedded scenarios) that is never created. Streams each turn's result as it happens, then a final pass/fail summary; exits non-zero when the run fails. Use --format to pick the output (text stream, JSONL, or an html/pdf report) and --output to write it to a file. For a static SMS/VOICE_PRERECORDED render (no conversation), use agents:preview instead.

USAGE
  $ qcobro agents:eval [--template-id <value>] [--scenarios <value>] [--file <value>] [--format
    text|json|html|pdf] [--output <value>] [--title <value>]

FLAGS
  --file=<value>         path to a standalone YAML eval template (agent definition + embedded scenarios)
  --format=<option>      [default: text] text = human-readable stream (default); json = JSONL of raw events; html/pdf =
                         a self-contained evaluation report (requires --output)
                         <options: text|json|html|pdf>
  --output=<value>       write output to this file instead of stdout (required for html/pdf)
  --scenarios=<value>    path to a YAML file with the scenarios to run (used with --template-id)
  --template-id=<value>  an existing agent template id
  --title=<value>        report title for --format html/pdf (default is generic; pass a client name at run time if you
                         want one)

DESCRIPTION
  evaluate a VOICE_AI/EMAIL/WHATSAPP agent's conversation logic — either an existing template plus a scenarios file, or
  a standalone YAML eval template (agent definition plus its own embedded scenarios) that is never created. Streams each
  turn's result as it happens, then a final pass/fail summary; exits non-zero when the run fails. Use --format to pick
  the output (text stream, JSONL, or an html/pdf report) and --output to write it to a file. For a static
  SMS/VOICE_PRERECORDED render (no conversation), use `agents:preview` instead.

EXAMPLES
  $ qcobro agents:eval --template-id <id> --scenarios scenarios.yaml

  $ qcobro agents:eval --file eval-template.yaml

  $ qcobro agents:eval --file eval-template.yaml --format json --output run.json

  $ qcobro agents:eval --file eval-template.yaml --format pdf --output report.pdf

qcobro agents:preview

render an SMS/VOICE_PRERECORDED agent template's message body or script against a sample account — no conversation, no streaming. Accepts an existing template id or a standalone YAML definition. For VOICE_AI/EMAIL/WHATSAPP, use agents:eval instead.

USAGE
  $ qcobro agents:preview --account <value> [--template-id <value>] [--file <value>]

FLAGS
  --account=<value>      (required) path to a JSON file with the sample account fields
  --file=<value>         path to a standalone YAML SMS/VOICE_PRERECORDED definition
  --template-id=<value>  an existing agent template id

DESCRIPTION
  render an SMS/VOICE_PRERECORDED agent template's message body or script against a sample account — no conversation, no
  streaming. Accepts an existing template id or a standalone YAML definition. For VOICE_AI/EMAIL/WHATSAPP, use
  `agents:eval` instead.

EXAMPLES
  $ qcobro agents:preview --template-id <id> --account account.json

  $ qcobro agents:preview --file sms-draft.yaml --account account.json

qcobro agents:sync TEMPLATEID

re-attempt an agent template's Fonoster sync and report the resulting status. This validates the template's configuration and its sync with Fonoster — it does not test conversation behavior (see agents:eval for that). Only VOICE_AI templates sync with Fonoster; other channel types are a no-op that leaves the template unchanged.

USAGE
  $ qcobro agents:sync TEMPLATEID

ARGUMENTS
  TEMPLATEID  the agent template id

DESCRIPTION
  re-attempt an agent template's Fonoster sync and report the resulting status. This validates the template's
  configuration and its sync with Fonoster — it does not test conversation behavior (see `agents:eval` for that). Only
  VOICE_AI templates sync with Fonoster; other channel types are a no-op that leaves the template unchanged.

EXAMPLES
  $ qcobro agents:sync <templateId>

qcobro mcp:configure

configure an MCP client to use @qcobro/mcp

USAGE
  $ qcobro mcp:configure [-c claude] [--url <value>] [--access-key-id <value>] [--access-key-secret <value>]
    [--workspace <value>]

FLAGS
  -c, --client=<option>            [default: claude] MCP client to configure
                                   <options: claude>
      --access-key-id=<value>      workspace API key id (overrides active workspace)
      --access-key-secret=<value>  workspace API key secret (overrides active workspace)
      --url=<value>                [default: https://api.qcobro.com] QCobro API base URL
      --workspace=<value>          workspace to act in, its accessKeyId (overrides active workspace)

DESCRIPTION
  configure an MCP client to use @qcobro/mcp

EXAMPLES
  $ qcobro mcp:configure

  $ qcobro mcp:configure --client claude

  $ qcobro mcp:configure --access-key-id <id> --access-key-secret <secret> --workspace <workspaceAccessKeyId>

qcobro portfolios:get ID

display a single portfolio

USAGE
  $ qcobro portfolios:get ID

ARGUMENTS
  ID  the portfolio id

DESCRIPTION
  display a single portfolio

EXAMPLES
  $ qcobro portfolios:get <id>

qcobro portfolios:list

display the active workspace's portfolios

USAGE
  $ qcobro portfolios:list [--include-archived]

FLAGS
  --include-archived  include archived portfolios

DESCRIPTION
  display the active workspace's portfolios

EXAMPLES
  $ qcobro portfolios:list

  $ qcobro portfolios:list --include-archived

qcobro portfolios:sync

synchronize a batch of account rows into a portfolio, from a JSON file

USAGE
  $ qcobro portfolios:sync --portfolio-id <value> --file <value> [--mode APPEND_ONLY|UPDATE_EXISTING|REPLACE]

FLAGS
  --file=<value>          (required) path to a JSON file containing an array of account rows
  --mode=<option>         [default: APPEND_ONLY] merge strategy
                          <options: APPEND_ONLY|UPDATE_EXISTING|REPLACE>
  --portfolio-id=<value>  (required) the portfolio id

DESCRIPTION
  synchronize a batch of account rows into a portfolio, from a JSON file

EXAMPLES
  $ qcobro portfolios:sync --portfolio-id <id> --file rows.json --mode APPEND_ONLY

qcobro workspaces:active

display the active QCobro workspace

USAGE
  $ qcobro workspaces:active

DESCRIPTION
  display the active QCobro workspace

EXAMPLES
  $ qcobro workspaces:active

qcobro workspaces:list

display all linked QCobro workspaces

USAGE
  $ qcobro workspaces:list

DESCRIPTION
  display all linked QCobro workspaces

EXAMPLES
  $ qcobro workspaces:list

qcobro workspaces:login

link a QCobro workspace to the local environment

USAGE
  $ qcobro workspaces:login

DESCRIPTION
  link a QCobro workspace to the local environment

EXAMPLES
  $ qcobro workspaces:login

qcobro workspaces:logout WORKSPACEACCESSKEYID

unlink a QCobro workspace from the local environment

USAGE
  $ qcobro workspaces:logout WORKSPACEACCESSKEYID

ARGUMENTS
  WORKSPACEACCESSKEYID  the workspace to unlink (its accessKeyId)

DESCRIPTION
  unlink a QCobro workspace from the local environment

EXAMPLES
  $ qcobro workspaces:logout WO6ueex0qan9ojhf820wgiae3qi5luy08y

qcobro workspaces:use WORKSPACEACCESSKEYID

set a linked workspace as the active one

USAGE
  $ qcobro workspaces:use WORKSPACEACCESSKEYID

ARGUMENTS
  WORKSPACEACCESSKEYID  the workspace to activate (its accessKeyId)

DESCRIPTION
  set a linked workspace as the active one

EXAMPLES
  $ qcobro workspaces:use WO6ueex0qan9ojhf820wgiae3qi5luy08y