Skip to main content

A16nPlugin

@a16njs/models


@a16njs/models / A16nPlugin

Interface: A16nPlugin

Defined in: plugin.ts:70

The plugin interface that all a16n plugins must implement. Plugins bridge between a16n's internal model and a specific tool's format.

Properties

id

id: string

Defined in: plugin.ts:72

Unique identifier, e.g., 'cursor', 'claude', 'codex'


name

name: string

Defined in: plugin.ts:74

Human-readable name


supports

supports: CustomizationType[]

Defined in: plugin.ts:76

Which customization types this plugin supports


pathPatterns?

optional pathPatterns: PluginPathPatterns

Defined in: plugin.ts:78

Path patterns for this plugin's file format (used by transformations)

Methods

discover()

discover(rootOrWorkspace): Promise<DiscoveryResult>

Defined in: plugin.ts:85

Discover all agent customizations in a directory tree.

Parameters

rootOrWorkspace

The root directory path or Workspace to search

string | Workspace

Returns

Promise<DiscoveryResult>

All customizations found and any warnings


emit()

emit(models, rootOrWorkspace, options?): Promise<EmitResult>

Defined in: plugin.ts:94

Emit customization models to disk in this plugin's format.

Parameters

models

AgentCustomization[]

The customizations to emit

rootOrWorkspace

The root directory path or Workspace to write to

string | Workspace

options?

EmitOptions

Optional emit options (e.g., dryRun)

Returns

Promise<EmitResult>

Info about what was written (or would be written) and any issues