The elmah.io CLI

A .NET tool for your terminal and your build pipeline. Tail and export log messages, create deployments and check an installation. Free on every plan.

A command-line tool for logs and deployments

AI overview › CLI

The elmah.io CLI is a .NET global tool. Use it to tail and export log messages, create deployments from your build pipeline, and check an installation. It is free and works on every plan.

Install it

The CLI requires .NET 10 or newer.

dotnet tool install --global Elmah.Io.Cli
elmahio login --apiKey API_KEY

In CI and other non-interactive places, skip login and set the ELMAHIO_API_KEY environment variable instead. Update later with dotnet tool update --global Elmah.Io.Cli.

What you can do

CommandWhat it does
elmahio logs list, logs getList your logs and get details for one.
elmahio logs tailTail messages as they arrive in a log.
elmahio logs exportExport messages to JSON or CSV for a date range, with an optional query.
elmahio messages list-recent, list-frequentList the newest or the most frequent messages in a log.
elmahio messages count, getCount messages that match a query, or get one message.
elmahio messages createLog a message from a script.
elmahio deployments create, listTell elmah.io about a release, and list recent deployments.
elmahio diagnoseCheck an elmah.io installation for configuration problems.

The message commands accept --json, so you can pipe the output into scripts.

Examples

Create a deployment at the end of a pipeline:

elmahio deployments create --version 1.0.0

Export a week of messages as CSV:

elmahio logs export --logId LOG_ID --dateFrom 2026-08-21 --dateTo 2026-08-28 --format Csv

Find the ten most frequent errors:

elmahio messages list-frequent --logId LOG_ID --count 10 --json

Use it with an AI assistant

The CLI is an ordinary command-line tool, so an AI assistant that can run shell commands can use it too. For direct access from inside your editor, add the MCP server.

Frequently asked questions

Do I need the CLI?

No. It is for terminals, scripts and CI. The dashboard, the MCP server and the REST API cover the same data.

The .NET 10 runtime or newer, and an API key with permission to run the commands you use.

No. The CLI is free and works on every plan.

Try it on your own logs
Start a 21-day trial and install the NuGet or npm package. Then install the CLI and tail your first log.
Start free trial
Free 21-day trial No credit card required