PHPackages                             spatie/flare-cli - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging &amp; Monitoring](/categories/logging)
4. /
5. spatie/flare-cli

ActiveProject[Logging &amp; Monitoring](/categories/logging)

spatie/flare-cli
================

A standalone CLI tool for Flare error tracking and performance monitoring.

1.1.0(2mo ago)3431↑121.9%1[2 PRs](https://github.com/spatie/flare-cli/pulls)MITPHPPHP ^8.4CI passing

Since Feb 12Pushed 1mo agoCompare

[ Source](https://github.com/spatie/flare-cli)[ Packagist](https://packagist.org/packages/spatie/flare-cli)[ Docs](https://flareapp.io)[ GitHub Sponsors](https://github.com/spatie)[ RSS](/packages/spatie-flare-cli/feed)WikiDiscussions main Synced today

READMEChangelog (6)Dependencies (22)Versions (13)Used By (0)

Flare CLI
=========

[](#flare-cli)

[![Latest Version on Packagist](https://camo.githubusercontent.com/9f142dfe6b2a71d9079e46d69a026d9dcb149e455010b5dfa21f64ecd85d3f19/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f666c6172652d636c692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/flare-cli)[![GitHub Tests Action Status](https://github.com/spatie/flare-cli/actions/workflows/run-tests.yml/badge.svg)](https://github.com/spatie/flare-cli/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://github.com/spatie/flare-cli/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/spatie/flare-cli/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/3ff1634e612685fd17c4443ffc82e2f47f3fbd6ab7211edd4890d8a4b546eb30/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f666c6172652d636c692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/flare-cli)

A command-line tool for [Flare](https://flareapp.io) — interact with the Flare API from your terminal.

[![Flare CLI](art/screenshot.png)](art/screenshot.png)

Installation
------------

[](#installation)

```
composer global require spatie/flare-cli
```

Make sure Composer's global bin directory is in your `PATH`. You can find the path with:

```
composer global config bin-dir --absolute
```

Updating
--------

[](#updating)

```
composer global require spatie/flare-cli
```

Usage
-----

[](#usage)

### Authentication

[](#authentication)

```
# Log in with your Flare API token
flare login

# Log out
flare logout
```

Get your API token at [flareapp.io/settings/api-tokens](https://flareapp.io/settings/api-tokens).

### Commands

[](#commands)

Every Flare API endpoint has a corresponding command. Run `flare  --help` for details on a specific command.

```
flare list-projects
flare create-project --field name="My App" --field team_id=1 --field stage=production --field technology=Laravel
flare delete-project --project-id=

flare list-project-errors --project-id=
flare list-error-occurrences --error-id=
flare get-error-occurrence --occurrence-id=
flare get-project-error-count --project-id= --start-date= --end-date=
flare get-project-error-occurrence-count --project-id= --start-date= --end-date=

flare resolve-error --error-id=
flare unresolve-error --error-id=
flare snooze-error --error-id=
flare unsnooze-error --error-id=

flare get-team --team-id=
flare remove-team-user --team-id= --user-id=
flare get-authenticated-user

flare get-monitoring-summary --project-id=
flare list-monitoring-aggregations --project-id= --type=routes
flare get-monitoring-time-series --project-id= --type=routes
flare get-monitoring-aggregation --type=routes --uuid=
flare list-aggregation-traces --type=routes --uuid=
flare get-trace --trace-id=
```

Agent Skill
-----------

[](#agent-skill)

This repository includes an [agent skill](https://skills.sh) that teaches coding agents how to use the Flare CLI.

### Install

[](#install)

```
flare install-skill
```

Testing
-------

[](#testing)

```
composer test
```

Releasing a new version
-----------------------

[](#releasing-a-new-version)

1. **Build the PHAR**:

    ```
    php flare app:build flare --build-version=1.x.x
    ```

    This bakes the version into `builds/flare`. If you omit `--build-version`, it will prompt you (defaulting to the latest git tag).
2. **Commit and push**:

    ```
    git add builds/flare
    git commit -m "Release v1.x.x"
    git push origin main
    ```
3. **Create a release** in the GitHub UI — this creates the tag, triggers Packagist, and automatically updates the changelog.

Users install or update with `composer global require spatie/flare-cli`.

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Alex Vanderbist](https://github.com/alexvanderbist)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

48

—

FairBetter than 93% of packages

Maintenance89

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~10 days

Total

6

Last Release

87d ago

Major Versions

0.0.2 → 1.0.02026-02-19

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7535935?v=4)[Spatie](/maintainers/spatie)[@spatie](https://github.com/spatie)

---

Top Contributors

[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (50 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (27 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (24 commits)")[![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (9 commits)")

---

Tags

spatieclimonitoringflareerror-tracking

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/spatie-flare-cli/health.svg)

```
[![Health](https://phpackages.com/badges/spatie-flare-cli/health.svg)](https://phpackages.com/packages/spatie-flare-cli)
```

###  Alternatives

[spatie/flare-client-php

Send PHP errors to Flare

177161.5M23](/packages/spatie-flare-client-php)[spatie/laravel-error-share

Share your Laravel errors to Flare

431.4M6](/packages/spatie-laravel-error-share)[muhammadsadeeq/laravel-activitylog-ui

A beautiful, modern UI for Spatie's Activity Log with advanced filtering, analytics, and real-time features.

17717.0k](/packages/muhammadsadeeq-laravel-activitylog-ui)[lordsimal/cakephp-sentry

Sentry plugin for CakePHP

12317.3k](/packages/lordsimal-cakephp-sentry)[inspector-apm/inspector-symfony

Code Execution Monitoring for Symfony applications.

2839.2k10](/packages/inspector-apm-inspector-symfony)[ohdearapp/ohdear-cli

A standalone CLI tool for Oh Dear monitoring.

1401.3k](/packages/ohdearapp-ohdear-cli)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
