TargetConfig
Defined in: core/src/types/config.ts:82
Configuration for a single target.
Properties
agentsFile?
optionalagentsFile?:string
Defined in: core/src/types/config.ts:172
Codex: override the agents file name for scoped build profiles.
Defaults to AGENTS.md. Use AGENTS.override.md only for scoped builds.
agentsFrontmatter?
optionalagentsFrontmatter?:"experimental"
Defined in: core/src/types/config.ts:182
AGENTS.md v1.1 frontmatter mode.
experimental: emit YAML frontmatter withdescriptionandtagsfrom
Meta
- omitted: no frontmatter (default, byte-compatible with existing output)
Only valid for targets whose fixture accepts frontmatter.
Default
undefined (no frontmatter)autoMode?
optionalautoMode?:"acceptEdits"|"plan"|"bypassPermissions"
Defined in: core/src/types/config.ts:189
Claude: auto mode setting for project settings.json.
Maps to .claude/settings.json autoMode field.
Only valid for Claude target with fixture-confirmed project-local schema.
convention?
optionalconvention?:string
Defined in: core/src/types/config.ts:97
Output convention (‘xml’, ‘markdown’, or custom name).
enabled?
optionalenabled?:boolean
Defined in: core/src/types/config.ts:87
Whether this target is enabled.
Default
trueexcludeAgents?
optionalexcludeAgents?:string[]
Defined in: core/src/types/config.ts:145
Agent names never emitted for this target. Applied after includeAgents.
guardsAsSkills?
optionalguardsAsSkills?:boolean
Defined in: core/src/types/config.ts:114
Generate skills from
Guards
named entries (Factory).
Default
trueguardsSkillsListing?
optionalguardsSkillsListing?:boolean
Defined in: core/src/types/config.ts:117
List generated guard skills in main output file (Factory).
Default
truehooksFile?
optionalhooksFile?:FactoryHooksFile
Defined in: core/src/types/config.ts:206
Factory: file that receives the generated @hooks.
hooks.json:.factory/hooks.json(preferred by Factory, read first)settings.json:hookskey of.factory/settings.json(Factory reads it only when.factory/hooks.jsonis absent)
Default
'hooks.json'includeAgents?
optionalincludeAgents?:boolean|string[]
Defined in: core/src/types/config.ts:140
Controls which agents are emitted for this target.
trueor omitted: emit all agentsfalse: emit no agents- string array: emit only the listed agent names
includeSkills?
optionalincludeSkills?:boolean|string[]
Defined in: core/src/types/config.ts:132
Controls which skills are emitted for this target.
trueor omitted: emit all skillsfalse: emit no skills- string array: emit only the listed skill names
maxDepth?
optionalmaxDepth?:number
Defined in: core/src/types/config.ts:166
Codex: maximum nesting depth for agent delegation. Positive integer. Maps to Codex config, never to AGENTS.md.
maxThreads?
optionalmaxThreads?:number
Defined in: core/src/types/config.ts:160
Codex: maximum number of parallel agent threads. Positive integer. Maps to Codex config, never to AGENTS.md.
output?
optionaloutput?:string
Defined in: core/src/types/config.ts:92
Custom output path for this target.
rulesMode?
optionalrulesMode?:FactoryRulesMode
Defined in: core/src/types/config.ts:111
Factory always-on rules output mode.
Split mode requires Factory’s multifile or full version.
Default
'monolith'settings?
optionalsettings?:TargetSettingsConfig
Defined in: core/src/types/config.ts:197
Project settings written to the target settings file.
Claude: .claude/settings.json (model, permissions, env, enabledPlugins).
Factory: .factory/settings.json (model, enabledPlugins).
Keys are merged into an existing settings file; other user keys are kept.
skillBaseDir?
optionalskillBaseDir?:string
Defined in: core/src/types/config.ts:124
Custom base directory for generated skill files.
When set, skill files are emitted under this directory instead of the
target’s native skill directory (for example .factory/skills).
skillPath?
optionalskillPath?:"agents"|"gemini"|"both"
Defined in: core/src/types/config.ts:154
Gemini skill path selection.
agents: use.agents/skills/(interoperable, fixture-confirmed default)gemini: use.gemini/skills/(legacy)both: emit to both paths (requires explicit opt-in, deduplicates content)
Default
'agents'version?
optionalversion?:string
Defined in: core/src/types/config.ts:104
Target version or format variant. Use ‘legacy’ for deprecated formats (e.g., Cursor’s .cursorrules).
Example
'legacy' | '1.0' | '2.0'