Skip to content

[docs] Update documentation for features from 2026-05-22 #1458

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
danielmeppiel wants to merge 1 commit into
base: main
Choose a base branch
from
+24 −5
Open

[docs] Update documentation for features from 2026-05-22 #1458

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 17 additions & 2 deletions docs/src/content/docs/consumer/install-mcp-servers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,14 +29,18 @@ dependencies:
# 1. Registry reference (bare string)
- io.github.github/github-mcp-server

# 2. Self-defined stdio (local process)
# 2. Registry reference with a per-dep custom registry URL
- name: my-internal-server
registry: https://registry.internal.example.com

# 3. Self-defined stdio (local process)
- name: filesystem
registry: false
transport: stdio
command: npx
args: ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]

# 3. Self-defined remote (HTTP / SSE)
# 4. Self-defined remote (HTTP / SSE)
- name: linear
Comment on lines +32 to 44
registry: false
transport: http
Expand All @@ -45,6 +49,17 @@ dependencies:
Authorization: "Bearer ${LINEAR_TOKEN}"
```

When `registry:` is a string URL (form 2 above), APM routes that entry through
the specified registry instead of the global default (`https://api.mcp.github.com`).
Each dependency can point to a different registry; APM groups them and installs
each group via its own registry client. The `registry:` URL is persisted to
`apm.yml` and honored on every subsequent `apm install`. You can also set the
custom URL from the CLI with `--registry URL` when first adding the entry:

```bash
apm install --mcp my-internal-server --registry https://registry.internal.example.com
```

The full grammar (overlays, `${input:...}` variables, `tools:`
allowlists, `package:` selection) is in
[Package Anatomy](../../concepts/package-anatomy/).
Expand Down
6 changes: 5 additions & 1 deletion docs/src/content/docs/reference/cli/targets.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ match per target is enough to activate it.
| Target | Signal(s) APM looks for | Deploy directory |
|--------|-------------------------|------------------|
| `claude` | `.claude/` directory, or `CLAUDE.md` file | `.claude/` |
| `copilot` | `.github/copilot-instructions.md` file | `.github/` |
| `copilot` | `.github/copilot-instructions.md` file (monolithic), or `.github/instructions/`, `.github/agents/`, `.github/prompts/`, `.github/hooks/` directories (file-based layout) | `.github/` |
| `cursor` | `.cursor/` directory, or `.cursorrules` file (legacy) | `.cursor/` |
| `codex` | `.codex/` directory | `.codex/` |
| `gemini` | `.gemini/` directory, or `GEMINI.md` file | `.gemini/` |
Expand All @@ -104,6 +104,10 @@ Notes:

- Detection is filesystem-only. APM does not inspect file contents to
decide whether a marker is "real".
- Copilot is detected by either the monolithic `.github/copilot-instructions.md`
file OR by the presence of any file-based layout directory
(`.github/instructions/`, `.github/agents/`, `.github/prompts/`,
`.github/hooks/`). Any one of these is sufficient.
- A `CLAUDE.md` written as documentation will still activate the
`claude` target. Pin `targets:` in `apm.yml` to override.
- If no signals are found and `apm.yml` declares no `targets:`,
Expand Down
4 changes: 2 additions & 2 deletions docs/src/content/docs/reference/targets-matrix.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ list before `compile` or `install`.
| Target | Signals (any one activates the target) |
|----------|-----------------------------------------------|
| claude | `.claude/` directory, or `CLAUDE.md` file |
| copilot | `.github/copilot-instructions.md` file |
| copilot | `.github/copilot-instructions.md` file, or `.github/instructions/`, `.github/agents/`, `.github/prompts/`, `.github/hooks/` directories |
| cursor | `.cursor/` directory, or `.cursorrules` file |
| codex | `.codex/` directory |
| gemini | `.gemini/` directory, or `GEMINI.md` file |
Expand All @@ -70,7 +70,7 @@ a project's `apm.yml` `targets:` field so contributors running plain

GitHub Copilot (CLI and IDE).

- **Detection.** `.github/copilot-instructions.md`.
- **Detection.** `.github/copilot-instructions.md` (monolithic), or any of `.github/instructions/`, `.github/agents/`, `.github/prompts/`, `.github/hooks/` directories (file-based layout).
- **Deploy directory.** `.github/` at project scope; `~/.copilot/` at user scope.
- **Supported primitives.** instructions, prompts, agents, skills, hooks, mcp.
- **File conventions.**
Expand Down
Loading