PHPackages                             vitorsreis/sift - 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. [CLI & Console](/categories/cli)
4. /
5. vitorsreis/sift

ActiveComposer-plugin[CLI & Console](/categories/cli)

vitorsreis/sift
===============

Agent tooling and skills layer for PHP projects.

v2.4.3(1w ago)1593[1 PRs](https://github.com/vitorsreis/sift/pulls)MITPHPPHP ^8.3CI passing

Since Apr 9Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/vitorsreis/sift)[ Packagist](https://packagist.org/packages/vitorsreis/sift)[ RSS](/packages/vitorsreis-sift/feed)WikiDiscussions master Synced yesterday

READMEChangelog (5)Dependencies (45)Versions (14)Used By (0)

 [![Sift](resources/logo.svg)](resources/logo.svg)

 **Composer-native skills and agent-friendly tooling for PHP projects.**

 [![PHP Version](https://camo.githubusercontent.com/0473d3c50b3dcd3865707f9134dbc8c2c039aa284fcdd2df91b399861c7a0f0d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7669746f7273726569732f736966743f636f6c6f723d373737626234)](https://packagist.org/packages/vitorsreis/sift) [![Packagist Downloads](https://camo.githubusercontent.com/92bde9514e66489cf4a5003a92e5227864e51a1fa924ea7245edd344c79c9153/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7669746f7273726569732f736966743f636f6c6f723d323536336562)](https://packagist.org/packages/vitorsreis/sift) [![CI](https://camo.githubusercontent.com/88377e0a4015357f4be9641e9ee11a3180d246d1d544025e8008075191664949/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7669746f7273726569732f736966742f63692e796d6c3f6272616e63683d6d6173746572266c6162656c3d6369)](https://github.com/vitorsreis/sift/actions/workflows/ci.yml) [![License](https://camo.githubusercontent.com/70e630a6a95b611244735410049920d5017a05aff19912622546202ad2af69bd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7669746f7273726569732f736966743f636f6c6f723d313661333461)](https://github.com/vitorsreis/sift/blob/master/LICENSE.md)

[![Sift preview](resources/preview.svg)](resources/preview.svg)

---

Sift helps PHP teams make coding agents more useful with less repeated context.

It adds two Composer-first workflows:

- `composer skills`: install and manage reusable agent skills inside the project.
- `composer sift `: run PHP tools with compact, normalized, agent-friendly output.

Instead of pasting the same project rules, commands, testing conventions, and huge terminal logs into every session, Sift keeps instructions and tool results structured. Agents can start from a small summary and inspect stored history only when they need more detail.

Why Sift
--------

[](#why-sift)

- **Manage skills through Composer** for the open agent target set, including a standard shared target, Cursor, Claude Code, GitHub Copilot, Gemini CLI, OpenCode, Antigravity, Windsurf, and project or global installs.
- **Reduce wasted tokens** by replacing raw tool output with compact summaries and paginated history.
- **Run 15+ PHP tools** through one command layer.
- **Keep automation safer** with read-only Composer reports, dry-run refactors, safe formatter modes, blocked arguments, timeouts, and redacted history.
- **Use the same core everywhere** through `composer sift`, `composer skills`, `vendor/bin/sift`, or the PHAR.

Quick Start
-----------

[](#quick-start)

Install Sift globally:

```
composer global config allow-plugins.vitorsreis/sift true
composer global require vitorsreis/sift
```

Or install Sift in a single project:

```
composer config allow-plugins.vitorsreis/sift true
composer require --dev vitorsreis/sift
```

After installation, initialize Sift in your project:

```
composer sift init
```

Skills
------

[](#skills)

Sift brings a Composer workflow for agent instructions:

```
composer skills find
composer skills add owner/repo@skill
```

Supported skill sources:

- bundled skills, such as `sift`;
- local paths;
- GitHub shorthand, such as `owner/repo`;
- GitHub URLs.

Other commands include `init`, `list`, `find`, `use`, `update` / `upgrade`, and `remove`. In terminal mode, `composer skills` opens a bannered help screen and `composer skills find` opens an interactive search with typeahead, arrow-key selection, and Enter-to-select before install.

Without a scope flag, `composer skills add` installs to project skill directories, including the `standard` `.agents/skills` target for Cursor, Gemini CLI, GitHub Copilot, OpenCode, Antigravity, Amp, Replit, and other shared project installs. It accepts multi-value flags such as `--agent standard cursor` and `--skill pr-review commit`. Use `--global` / `-g` for user-level installs, `--subagent reviewer` for Eve subagents, or omit `--agent` in terminal mode to choose agents interactively; existing target folders in the current scope are preselected and Sift prompts for Project or Global scope when applicable.

Tools
-----

[](#tools)

Use `composer sift tools list` to check availability in your project and `composer sift ` to run with compact output.

For test runners, Sift injects machine-readable reports when needed. If the runner exits before those reports are written, the normalized payload reports the native error message and keeps raw stdout/stderr in `extra`.

#### Supported tools:

[](#supported-tools)

- `pest`
- `phpunit`
- `paratest`
- `phpstan`
- `psalm`
- `phpcs`
- `phpcbf`
- `pint`
- `rector`
- `mago`
- `infection`
- `deptrac`
- `php-cs-fixer`
- `phpmd`
- `composer-require-checker`
- `composer-unused`
- `parallel-lint`
- `composer audit|licenses|outdated|show|validate`

Documentation
-------------

[](#documentation)

- [Getting started](docs/getting-started.md)
- [CLI reference](docs/cli.md)
- [Configuration](docs/configuration.md)
- [Tools](docs/tools.md)
- [Skills](docs/skills.md)
- [Payloads](docs/payloads.md)
- [Architecture](docs/architecture.md)
- [PHAR](docs/phar.md)
- [Contributing](docs/contributing.md)

License
-------

[](#license)

Released under the [MIT license](LICENSE.md).

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance94

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 99.7% 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 ~10 days

Total

11

Last Release

13d ago

Major Versions

v1.0.0 → v2.0.02026-06-04

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/97206761?v=4)[Vitor Reis](/maintainers/vitorsreis)[@vitorsreis](https://github.com/vitorsreis)

---

Top Contributors

[![vitorsreis](https://avatars.githubusercontent.com/u/97206761?v=4)](https://github.com/vitorsreis "vitorsreis (348 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

agentaiclicomposer-pluginphptoolingphpcliaiAgentskillstooling

###  Code Quality

TestsPest

Static AnalysisPHPStan, Psalm, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/vitorsreis-sift/health.svg)

```
[![Health](https://phpackages.com/badges/vitorsreis-sift/health.svg)](https://phpackages.com/packages/vitorsreis-sift)
```

###  Alternatives

[phpro/grumphp

A composer plugin that enables source code quality checks.

4.3k17.0M1.1k](/packages/phpro-grumphp)

PHPackages © 2026

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