PHPackages                             thinkliveid/crew - 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 &amp; Console](/categories/cli)
4. /
5. thinkliveid/crew

ActiveLibrary[CLI &amp; Console](/categories/cli)

thinkliveid/crew
================

A PHP CLI tool for managing AI agent skills, guidelines, and MCP configurations across multiple IDE coding assistants.

v1.1.4(2mo ago)25↓66.7%MITPHPPHP ^8.3CI failing

Since Feb 24Pushed 2mo agoCompare

[ Source](https://github.com/thinkliveid/crew)[ Packagist](https://packagist.org/packages/thinkliveid/crew)[ Docs](https://github.com/thinkliveid/crew)[ RSS](/packages/thinkliveid-crew/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (8)Versions (10)Used By (0)

Crew
====

[](#crew)

A PHP CLI tool for managing AI agent skills, sub-agents, and team templates across multiple IDE coding assistants.

Crew discovers which AI agents are installed on your system, downloads resources from GitHub repositories, syncs local definitions, and writes configurations to the correct agent-specific directories — all from a single command.

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

[](#requirements)

- PHP 8.3+
- Composer

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

[](#installation)

```
composer require thinkliveid/crew
```

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

[](#quick-start)

```
# Full setup: detect agents, sync local skills, install GitHub skills
crew install:skill

# Create a new skill from scratch
crew new:skill

# Add skills from a GitHub repository
crew add:skill owner/repo

# Update all configured skills to the latest version
crew update:skill
```

Supported Agents
----------------

[](#supported-agents)

Crew auto-detects the following AI coding assistants on your system and in your project:

AgentSkills PathMCP Config PathClaude Code`.claude/skills``.mcp.json`Cursor`.cursor/skills``.cursor/mcp.json`GitHub Copilot`.github/skills``.vscode/mcp.json`Gemini CLI`.agents/skills``.gemini/settings.json`Junie`.junie/skills``.junie/mcp/mcp.json`Codex`.agents/skills``.codex/config.toml`OpenCode`.agents/skills``opencode.json`When you run `crew install:skill`, only detected agents are shown for selection. Resources are written to the correct paths for each selected agent.

Commands
--------

[](#commands)

Crew organises commands into four groups across three resource types:

SkillsSub-agentsTeams**new**`new:skill``new:subagent``new:team`**install**`install:skill``install:subagent``install:team`**add**`add:skill``add:subagent``add:team`**update**`update:skill``update:subagent``update:team`### `new:*` — Scaffold a new resource locally

[](#new--scaffold-a-new-resource-locally)

Create a new skill, sub-agent, or team definition from scratch with an interactive prompt.

```
# Interactive — prompts for name and description
crew new:skill
crew new:subagent
crew new:team

# Provide the name upfront to skip the name prompt
crew new:skill my-skill
crew new:subagent my-agent
crew new:team my-team
```

Generated files:

CommandOutput`new:skill``.ai/skills/{name}/SKILL.md``new:subagent``.ai/agents/{name}.md``new:team``.ai/teams/{name}/TEAM.md`Names must be lowercase alphanumeric with hyphens (1–64 chars, no leading/trailing/consecutive hyphens). `new:subagent` also prompts for a model choice (`sonnet`, `opus`, `haiku`, or `inherit`).

### `install:*` — Full setup flow

[](#install--full-setup-flow)

Runs the complete setup: detect agents, select them, sync local resources, and install from GitHub.

```
crew install:skill
crew install:subagent
crew install:team
```

Non-interactive mode (uses auto-detected agents, skips prompts):

```
crew install:skill --no-interaction
```

### `add:*` — Add from a GitHub repository

[](#add--add-from-a-github-repository)

Discover and install resources from a GitHub repository. The repository is saved to `crew.json` for future installs and updates.

```
# Interactive — prompts for repository if not provided
crew add:skill
crew add:subagent
crew add:team

# Direct — provide the repository
crew add:skill owner/repo
crew add:subagent owner/repo
crew add:team owner/repo

# Full GitHub URL with branch and subdirectory
crew add:skill https://github.com/owner/repo/tree/main/path/to/skills
```

### `update:*` — Update to the latest version

[](#update--update-to-the-latest-version)

Re-runs the install flow in non-interactive mode to refresh all local and GitHub resources.

```
crew update:skill
crew update:subagent
crew update:team
```

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

[](#configuration)

Crew stores its configuration in `crew.json` at the project root:

```
{
    "agents": ["claude_code", "junie"],
    "skills": ["owner/repo"],
    "subagents": ["owner/repo"],
    "teams": ["owner/repo"]
}
```

KeyTypeDescription`agents``string[]`Selected agent identifiers`skills``string[]`GitHub repositories to install skills from`subagents``string[]`GitHub repositories to install sub-agents from`teams``string[]`GitHub repositories to install team templates from`guidelines``bool`Whether guideline writing is enabled`mcp``bool`Whether MCP configuration is enabled`github_token``string`GitHub API token for private repositories### GitHub Authentication

[](#github-authentication)

For private repositories or to avoid API rate limits, set a GitHub token:

```
{
    "github_token": "ghp_your_token_here"
}
```

Or use an environment variable:

```
export GITHUB_TOKEN=ghp_your_token_here
```

Project Structure
-----------------

[](#project-structure)

### Local Resources

[](#local-resources)

Place resources in your project's `.ai/` directory:

```
.ai/
  skills/
    my-skill/
      SKILL.md
      other-files...
  agents/
    my-agent.md
  teams/
    my-team/
      TEAM.md

```

Running `crew install:skill` copies skills from `.ai/skills/` to each selected agent's skill directory (e.g., `.claude/skills/my-skill/`, `.junie/skills/my-skill/`). The same pattern applies to sub-agents and teams.

### Remote Resources (GitHub)

[](#remote-resources-github)

Crew discovers resources in GitHub repositories by traversing the repo tree and looking for marker files (`SKILL.md`, agent markdown files, `TEAM.md`).

Architecture
------------

[](#architecture)

Crew is built with a contract-driven architecture. Each agent implements interfaces that define its capabilities:

- **SupportsSkills** — agent can receive skill files
- **SupportsSubAgents** — agent can receive sub-agent definitions
- **SupportsTeams** — agent can receive team templates
- **SupportsGuidelines** — agent can receive guideline files
- **SupportsMcp** — agent can receive MCP server configurations

The detection system uses a strategy pattern to discover agents:

- **DirectoryDetectionStrategy** — checks for directories/paths (supports glob patterns)
- **FileDetectionStrategy** — checks for specific files in the project
- **CommandDetectionStrategy** — runs shell commands to detect installed tools
- **CompositeDetectionStrategy** — combines multiple strategies with OR logic

License
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance85

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

9

Last Release

77d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/34b982b41bb191ec0ffe4ca720efe890dddef5204feeefa763dc1a24feee8cdb?d=identicon)[purwantoid](/maintainers/purwantoid)

![](https://www.gravatar.com/avatar/9a03748e2f386da58d91eb04740ae9949b196be6e0a8f2fed253ec7ba0c7a44a?d=identicon)[smallerid](/maintainers/smallerid)

---

Top Contributors

[![thinkliveid](https://avatars.githubusercontent.com/u/202394371?v=4)](https://github.com/thinkliveid "thinkliveid (8 commits)")

---

Tags

phpclisymfonymcpaislimcodexcursornativeagentsskillsGeminicopilotopencodeclaudeJunie

### Embed Badge

![Health badge](/badges/thinkliveid-crew/health.svg)

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

###  Alternatives

[cognesy/instructor-php

The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control

310107.9k1](/packages/cognesy-instructor-php)[seregazhuk/php-watcher

Automatically restart PHP application once the source code changes

394137.8k4](/packages/seregazhuk-php-watcher)[mahocommerce/maho

Free and open source ecommerce platform, created in 2024 on the M1 platform, PHP 8.3+

1322.1k12](/packages/mahocommerce-maho)

PHPackages © 2026

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