---
draft: false
title: agentsmesh matrix
description: Display the feature-target compatibility matrix for your current AgentsMesh configuration. Shows which features are supported natively, embedded, or unsupported per tool.
---

Display the feature-target compatibility matrix for your current configuration. Shows which features are supported natively, embedded as projected skills, or not supported for each configured target.

**Project vs global:** Without `--global`, each cell reflects **project** catalog levels (`descriptor.capabilities`) combined with your `agentsmesh.yaml` conversion settings. With `--global`, cells use **global** catalog levels (`descriptor.globalSupport.capabilities` when present, otherwise the same as project). Those catalog tables are the source of truth for documentation — see the [Supported tools reference](../reference/supported-tools/) (**Feature matrix (project scope)** and **Feature matrix (global scope)**). The `SUPPORT_MATRIX` and `SUPPORT_MATRIX_GLOBAL` exports in `src/core/matrix/data.ts` match those tables.

## Usage

```bash
agentsmesh matrix [flags]
```

## Flags

| Flag | Description |
|------|-------------|
| `--global` | Show the matrix for canonical home config under `~/.agentsmesh/`. |
| `--targets <csv>` | Limit matrix columns to specific target IDs. |
| `--verbose` | Show detailed feature notes alongside the matrix. |

## Examples

### Show full matrix

```bash
agentsmesh matrix
```

### Show matrix for specific targets

```bash
agentsmesh matrix --targets claude-code,cursor,copilot
```

### Show matrix with detailed notes

```bash
agentsmesh matrix --verbose
```

Shows per-file details for the canonical features present in the current project.

### Show the global-mode matrix

```bash
agentsmesh matrix --global
```

## Sample output

Column headers match the `targets` list in your `agentsmesh.yaml` (here: every built-in target). Feature labels include counts when your canonical tree has items (for example `commands (2)` or `additional rules (1)`). Set `NO_COLOR=1` to print plain symbols without ANSI colors. The block below illustrates **project-scope** catalog symbols for that full target list.

```
┌────────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┐
│Feature         │Claude      │cursor      │copilot     │continue    │junie       │kiro        │gemini-cli  │cline       │codex-cli   │windsurf    │antigravity │roo-code    │
├────────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┼────────────┤
│rules           │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │
│additional rules│  ✓         │  ◆         │  ✓         │  ✓         │  ✓         │  ✓         │  ◆         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │
│commands        │  ✓         │  ✓         │  ✓         │  ◆         │  ◆         │  –         │  ✓         │  ✓         │  ◆         │  ✓         │  ◐         │  ✓         │
│agents          │  ✓         │  ✓         │  ✓         │  –         │  ◆         │  ✓         │  ✓         │  ◆         │  ✓         │  ◆         │  –         │  –         │
│skills          │  ✓         │  ✓         │  ✓         │  ◆         │  ◆         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │
│mcp             │  ✓         │  ✓         │  –         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ✓         │  ◐         │  –         │  ✓         │
│hooks           │  ✓         │  ✓         │  ◐         │  –         │  –         │  ✓         │  ◐         │  ✓         │  –         │  ✓         │  –         │  –         │
│ignore          │  ✓         │  ✓         │  –         │  –         │  ✓         │  ✓         │  ✓         │  ✓         │  –         │  ✓         │  –         │  ✓         │
│permissions     │  ✓         │  ◐         │  –         │  –         │  –         │  –         │  ◐         │  –         │  –         │  –         │  –         │  –         │
└────────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┘

Legend: ✓ = native  ◆ = embedded  ◐ = partial  – = not supported
```

## Legend

| Symbol | Meaning |
|--------|---------|
| `✓` | Feature maps directly to the tool's native config format. |
| `◆` | Feature is projected into a compatible format with metadata for round-trip import. |
| `◐` | Limited support — some fields or behaviors may not round-trip. |
| `–` | Not supported. Feature is skipped for this target. |

## Using the matrix for planning

Before adding a new feature to your canonical config, run `agentsmesh matrix` to understand which tools will receive it natively and which will receive an embedded projection. This helps set expectations for team members using different tools.
