thinkliveid / crew
A PHP CLI tool for managing AI agent skills, guidelines, and MCP configurations across multiple IDE coding assistants.
Maintainers
Requires
- php: ^8.3
- guzzlehttp/guzzle: ^7.10
- symfony/console: ^7.0|^8.0
- symfony/process: ^8.0
- symfony/yaml: ^7.0|^8.0
README
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
- PHP 8.3+
- Composer
Installation
composer require thinkliveid/crew
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
Crew auto-detects the following AI coding assistants on your system and in your project:
| Agent | Skills Path | MCP Config Path |
|---|---|---|
| Claude 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
Crew organises commands into four groups across three resource types:
| Skills | Sub-agents | Teams | |
|---|---|---|---|
| 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
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:
| Command | Output |
|---|---|
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
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
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
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
Crew stores its configuration in crew.json at the project root:
{
"agents": ["claude_code", "junie"],
"skills": ["owner/repo"],
"subagents": ["owner/repo"],
"teams": ["owner/repo"]
}
| Key | Type | Description |
|---|---|---|
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
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
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)
Crew discovers resources in GitHub repositories by traversing the repo tree and looking for marker files (SKILL.md, agent markdown files, TEAM.md).
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
MIT