Getting Started

Installation

Install Gem Team via APM for your preferred AI coding tools.

1. Install APM

Install APM, the Agent Package Manager:

curl -sSL https://aka.ms/apm-unix | sh

irm https://aka.ms/apm-windows | iex

Verify it:

apm --version

2. Install Gem Team

# Project-scoped (recommended)
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#gem-team-v<version>' --target copilot

Replace <version> with a tag from GitHub Releases. Project installs record the resolved commit in apm.lock.yaml for reproducible setup.

Update

# Project-scoped
apm update mubaidr/gem-team --yes

# Global user-scoped
apm update -g mubaidr/gem-team --yes

Check for an APM CLI update without installing it:

Verify the Installation

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)

Useful 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

Use --refresh when the upstream cache is stale. For normal upgrades, use apm update [PACKAGE] --yes.

Generated Files

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

Commit generated project files-especially apm.yml, apm.lock.yaml, and harness directories. Keep apm_modules/ in .gitignore.

Direct Git installs read source primitives from .apm/; they do not require the generated build/ directory.

Overview

Turn AI coding into an engineering process; agents and skills that enforce good software engineering.

Usage

Day-to-day patterns for working with Gem Team.