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/projectThe 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/projectThe verify command confirms that:
- The native config exists at the expected path.
- All mandatory fields from the shared profile are present.
- The adapter-specific verification routine reports success.
Updating
apothem update --harness trae --project /path/to/projectRe-derives the project rules file from the current shared profile state.
Uninstalling
apothem uninstall --harness trae --project /path/to/projectRemoves 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
| Symptom | Fix |
|---|---|
| Config file not found | Re-run apothem install --harness trae --project /path/to/project |
| Verification failed | Run apothem update --harness trae --project /path/to/project, then verify again |
| Unexpected config content | Check ~/.config/apothem/profile.yaml or --profile PATH, then re-run apothem update --harness trae --project /path/to/project |
Configuration knobs
| Flag | Default | Description |
|---|---|---|
--dry-run | false | Preview install without writing files. |
See also
- All harnesses — the full catalog of supported tools
- Install guide — install Apothem into this harness
apothem harnessesreference — list and inspect adapters from the CLI