---
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)`). Colors are emitted only when output is an interactive terminal: piped or redirected output (for example `agentsmesh matrix | cat`) prints plain symbols with no ANSI codes, so consumers like scripts and AI agents get clean text. Set `NO_COLOR=1` to force plain symbols even in a terminal, or `FORCE_COLOR=1` to keep colors when piping. The block below illustrates **project-scope** catalog symbols for that full target list.

```
┌─────────────┬───────┬──────────────────┬──────────┬────────┬────────┬─────┬───────┬────────┬─────────────┐
│ Target      │ Rules │ Additional Rules │ Commands │ Agents │ Skills │ MCP │ Hooks │ Ignore │ Permissions │
├─────────────┼───────┼──────────────────┼──────────┼────────┼────────┼─────┼───────┼────────┼─────────────┤
│ antigravity │   ✓   │        ✓         │    ◐     │   ◆    │   ✓    │  –  │   ✓   │   –    │      ◐      │
├─────────────┼───────┼──────────────────┼──────────┼────────┼────────┼─────┼───────┼────────┼─────────────┤
│ Claude      │   ✓   │        ✓         │    ✓     │   ✓    │   ✓    │  ✓  │   ✓   │   ✓    │      ✓      │
├─────────────┼───────┼──────────────────┼──────────┼────────┼────────┼─────┼───────┼────────┼─────────────┤
│ cursor      │   ✓   │        ◆         │    ✓     │   ✓    │   ✓    │  ✓  │   ✓   │   ✓    │      ◐      │
├─────────────┼───────┼──────────────────┼──────────┼────────┼────────┼─────┼───────┼────────┼─────────────┤
│ roo-code    │   ✓   │        ✓         │    ✓     │   ◐    │   ✓    │  ✓  │   –   │   ✓    │      ◐      │
└─────────────┴───────┴──────────────────┴──────────┴────────┴────────┴─────┴───────┴────────┴─────────────┘

✓ native  ◆ embedded  ◐ partial  – none
```

## 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.
