Skip to content
Apothem
Harnesses

Trae

Apothem harness adapter for Trae (GA).

Vendor: ByteDance Install name: trae Status: GA Native config: <project>/.trae/rules/apothem-rules.md

Installation

apothem install --harness trae --project /path/to/project

The adapter writes one project-scope Trae rules file from the shared Apothem rules and governance surface.

Files written: <project>/.trae/rules/apothem-rules.md

Profile-to-native-config mapping

The adapter reads Apothem's shared profile and renders the project rules file on every apothem install or apothem update run. The shared profile is the source of truth; project-local edits to the generated file are backed up before the next sync replaces the Apothem-managed content.

Compatibility notes

Trae's current rules surface is project-scoped under .trae/rules/. The adapter writes a dedicated apothem-rules.md file alongside the operator-owned project_rules.md and user_rules.md anchors and never clobbers them. The .trae/mcp.json tool-server surface and .trae/skills/ skill surface are operator-owned; Apothem does not write them.

Verification

apothem verify --harness trae --project /path/to/project

The verify command confirms that:

  1. The native config exists at the expected path.
  2. All mandatory fields from the shared profile are present.
  3. The adapter-specific verification routine reports success.

Updating

apothem update --harness trae --project /path/to/project

Re-derives the project rules file from the current shared profile state.

Uninstalling

apothem uninstall --harness trae --project /path/to/project

Removes the native config files written by the adapter. The shared profile YAML and Apothem engine are unaffected.

Conformity gate

python -m apothem.conformity.gate --all .

Troubleshooting

SymptomFix
Config file not foundRe-run apothem install --harness trae --project /path/to/project
Verification failedRun apothem update --harness trae --project /path/to/project, then verify again
Unexpected config contentCheck ~/.config/apothem/profile.yaml or --profile PATH, then re-run apothem update --harness trae --project /path/to/project

Configuration knobs

FlagDefaultDescription
--dry-runfalsePreview install without writing files.

See also

On this page