PHPackages                             gordon-fcl/housekeeping - 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. gordon-fcl/housekeeping

ActiveLibrary

gordon-fcl/housekeeping
=======================

A Laravel package to view and manage GitHub issues from the terminal.

v0.7.0(1mo ago)06↑400%[7 issues](https://github.com/gordon-fcl/housekeeping/issues)MITPHPPHP ^8.2.0CI passing

Since Mar 17Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/gordon-fcl/housekeeping)[ Packagist](https://packagist.org/packages/gordon-fcl/housekeeping)[ Fund](https://www.paypal.com/paypalme/enunomaduro)[ GitHub Sponsors](https://github.com/nunomaduro)[ RSS](/packages/gordon-fcl-housekeeping/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (11)Versions (10)Used By (0)

Housekeeping
============

[](#housekeeping)

A Laravel package that brings GitHub issue management into the terminal, reducing context switching and keeping developers in flow.

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 10 or 11

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

[](#installation)

```
composer require gordon-fcl/housekeeping
```

The service provider is auto-discovered. No manual registration needed.

Configuration
-------------

[](#configuration)

Add your GitHub personal access token to `.env`:

```
GITHUB_TOKEN=ghp_your_token_here

```

The token needs `repo` scope to read issues and labels.

Optionally publish the config to customise the default label and base branch:

```
php artisan vendor:publish --tag=housekeeping-config
```

This creates `config/housekeeping.php` where you can set:

- `HOUSEKEEPING_LABEL` - default issue label to filter by (default: `housekeeping`)
- `HOUSEKEEPING_BASE_BRANCH` - branch to create working branches from (default: `staging`)

Usage
-----

[](#usage)

```
php artisan housekeeping:list
```

This will:

1. Fetch your GitHub repositories
2. Prompt you to select one
3. Fetch labels from that repository
4. Prompt you to select a label (or pass `--tag=bug` to skip)
5. Display matching issues in a table

### Options

[](#options)

```
php artisan housekeeping:list --tag=bug
```

Skip the label selection prompt by passing a label directly.

Development
-----------

[](#development)

```
git clone https://github.com/gordon-fcl/housekeeping.git
cd housekeeping
composer install
```

Run the test suite:

```
composer test
```

Individual checks:

```
composer lint          # Pint
composer test:types    # PHPStan
composer test:unit     # Pest
composer refacto       # Rector
```

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

[](#contributing)

Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on the fork-and-PR workflow.

Licence
-------

[](#licence)

MIT. See [LICENSE.md](LICENSE.md).

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance90

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.1% of commits — single point of failure

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 ~1 days

Total

7

Last Release

49d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8598e304d9f65ce87377a2bb02ac3fe2cb4bcd158704f65a7a954ac6193fd6a9?d=identicon)[gordon-fcl](/maintainers/gordon-fcl)

---

Top Contributors

[![gordon-fcl](https://avatars.githubusercontent.com/u/234153740?v=4)](https://github.com/gordon-fcl "gordon-fcl (27 commits)")[![ediblemanager](https://avatars.githubusercontent.com/u/436602?v=4)](https://github.com/ediblemanager "ediblemanager (4 commits)")

---

Tags

phplaravelgithubissueshousekeeping

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gordon-fcl-housekeeping/health.svg)

```
[![Health](https://phpackages.com/badges/gordon-fcl-housekeeping/health.svg)](https://phpackages.com/packages/gordon-fcl-housekeeping)
```

###  Alternatives

[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k43.5M5.2k](/packages/larastan-larastan)[laravel/boost

Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code.

3.4k10.6M274](/packages/laravel-boost)[laravel/wayfinder

Generate TypeScript representations of your Laravel actions and routes.

1.7k4.1M69](/packages/laravel-wayfinder)[livewire/flux

The official UI component library for Livewire.

9385.0M86](/packages/livewire-flux)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[nunomaduro/laravel-console-menu

Laravel Console Menu is an output method for your Laravel/Laravel Zero commands.

815412.0k48](/packages/nunomaduro-laravel-console-menu)

PHPackages © 2026

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