Getting Started
Installation
Install Gem Team via APM for your preferred AI coding tools.
Prerequisites
Install APM: the Agent Package Manager:
curl -sSL https://aka.ms/apm-unix | sh
irm https://aka.ms/apm-windows | iex
Verify the installation:
apm --version
Install Gem Team
# Project-scoped (recommended for teams)
apm install mubaidr/gem-team --target copilot,claude,cursor,opencode,codex,gemini,windsurf
# Global user-scoped
apm install -g mubaidr/gem-team
# Pin a specific release
apm install mubaidr/gem-team#v1.20.0 --target copilot
Verify
apm list
apm view mubaidr/gem-team
apm audit
Tool-specific checks:
copilot plugin list # GitHub Copilot CLI
/plugin list # Claude Code (inside Claude Code)
APM Flags
| Flag | Purpose |
|---|---|
--dry-run | Preview changes without writing files |
--target claude,cursor | Install only selected targets |
--target all | Install all supported targets |
--exclude codex | Exclude a target from auto-detection |
| (no flags) | Reinstall from existing apm.yml manifest |
What Gets Installed
APM writes different files depending on the selected target:
| Target | Output |
|---|---|
copilot | .github/agents/, .github/instructions/, .github/prompts/, VS Code MCP config |
claude | .claude/agents/, .claude/rules/, commands, skills, hooks, MCP config |
cursor | .cursor/agents/, .cursor/rules/, skills, commands, hooks, MCP config |
opencode | .opencode/agents/, commands, skills, MCP, compiled instructions |
codex | .codex/agents/, AGENTS.md, Codex config |
gemini | GEMINI.md, skills/instructions, Gemini config |
windsurf | .windsurf/rules/, skills, commands, hooks, MCP config |
After install, commit the generated files that belong to your repo: especially apm.yml, apm.lock.yaml, and harness directories. Keep apm_modules/ in .gitignore.