Frontmatter fields

Every supported field across every tool, in one table.

FieldToolsTypeUsed for
applyToCopilotstring | arrayScope glob
globsCursorarrayScope glob
alwaysApplyCursorboolForce "everywhere" scope
nameAll (agents, skills, modes)stringDuplicate-name detection
descriptionAllstringHuman label (shown in TUI/card)
toolsCopilot, Claude (agents)arrayAgent tool allowlist
modelCopilot, Claude (agents)stringOptional model hint (informational)

Parsing rules

  • aiscope uses serde_yaml under the hood.
  • Unknown fields are ignored, not errored — forward-compatible with whatever Copilot/Cursor/Claude add next.
  • Missing fields fall back to defaults (no scope = everywhere).
  • Both --- and +++ (TOML) delimiters are recognized.

Glob syntax

aiscope uses globset — same syntax as git:

PatternMatches
*.pyany .py in the current dir
**/*.pyany .py at any depth
apps/web/**everything under apps/web/
!**/test_*.pyexclusions are not yet supported

Examples

---
applyTo: "**/*.py" # Copilot
---
---
globs: # Cursor
  - "**/*.ts"
  - "**/*.tsx"
alwaysApply: false
---
---
name: reviewer # Claude / Copilot agent
description: "Reviews PRs"
tools: [read, search]
model: sonnet-4
---