@easycustomerfeedback/cli

ecf is the command-line interface for EasyCustomerFeedback. Triage feedback submissions, update statuses, and leave internal comments from your terminal.

Install

npm install -g @easycustomerfeedback/cli

Or run without installing:

npx @easycustomerfeedback/cli --help

Requires Node.js 18 or newer.

Getting started

1. In the EasyCustomerFeedback dashboard, open Integrations → Personal API tokens and create a token. Copy it — tokens are only shown once.

2. Log in:

   ecf login

   You'll be prompted for the server URL (defaults to https://easycustomerfeedback.com) and the token. Credentials are saved to ~/.config/ecf/config.json.

3. If you belong to multiple workspaces, pick a default:

   ecf workspace list
   ecf workspace use <workspaceId>

Commands

Authentication

| Command | What it does | | --- | --- | | ecf login | Configure server URL and API token. Auto-selects the workspace if you only have one. |

Workspaces

| Command | What it does | | --- | --- | | ecf workspace list | Show the workspaces you belong to (marks the active one). | | ecf workspace use <id> | Set the default workspace for future commands. |

Submissions

| Command | What it does | | --- | --- | | ecf submissions list [options] | List submissions in the active workspace. | | ecf submissions get <id> [--json] | Show details for a submission. | | ecf submissions status <id> <status> | Update a submission's status. | | ecf submissions comment <id> [body] | Add an internal comment (body may come from stdin). |

ecf submissions list options:

• --status <s> — filter by status (repeatable: untriaged, open, in_progress, resolved, closed)
• --type <t> — filter by type (bug, feature_request, general_feedback)
• --project <id> — filter by project
• --limit <n> — 1..200 (default 50)
• --workspace <id> — override the active workspace
• --json — output raw JSON

Valid status values for ecf submissions status: untriaged, open, in_progress, resolved, closed.

Examples

List open bugs, piped to your pager:

ecf submissions list --status open --type bug | less

Pipe a longer comment in from a file:

cat review.md | ecf submissions comment sub_abc123

Resolve a submission:

ecf submissions status sub_abc123 resolved

Configuration

Configuration lives at ~/.config/ecf/config.json and is created by ecf login. Delete the file to reset.

API reference

The CLI is a thin wrapper around the public REST API. See the API docs for everything the CLI exposes and more.

License

MIT