> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppSignal for Node.js: Demonstration tool

The AppSignal for Node.js package ships with a command line tool used to send demonstration samples to AppSignal. Upon running it, it sends an error and performance sample to AppSignal from the user's machine.

This command line tool is useful when testing AppSignal on a system and validating the local configuration. It tests if the installation of AppSignal has succeeded and if the AppSignal agent is able to run on the machine's architecture and communicate with the AppSignal servers.

Read more about how to use the demonstration command on the [Debugging][debugging] page.

## Usage

On the command line in your project run:

<CodeGroup>
  ```bash Bash theme={null}
  npx @appsignal/cli demo
  ```
</CodeGroup>

To run it with a specific environment, Push API key or application name, see the [CLI options](#options).

<CodeGroup>
  ```bash Bash theme={null}
  npx @appsignal/cli demo --environment=production --api-key="<PUSH API KEY HERE>" --application="My app"
  ```
</CodeGroup>

## Options

| Option                        | Description                                                                                                                                                     |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--api-key=<key>`             | Specify the Push API Key to use for the app. [Config option `pushApiKey`](/nodejs/3.x/configuration/options#option-pushapikey).                                 |
| `--application=<key>`         | The name of the app to send the demo samples for. [Config option `name`](/nodejs/3.x/configuration/options#option-name).                                        |
| `--environment=<environment>` | Set the environment to use in the command, e.g. `production` or `staging`. [Config option `environment`](/nodejs/3.x/configuration/options#option-environment). |

If no options are specified the demo tool will use the [environment variables of config options](/nodejs/3.x/configuration/options) if present.

[debugging]: /support/debugging.html
