Retornatus

Environments

Retornatus prefers native Environment capabilities over reimplementation.

Detection

retornatus wake
retornatus integrate
KindDetected whenBridges
cursor.cursor/ or Cursor env markersHub skill + retornatus.mdc (+ active Rules)
claude_codeCLAUDE.md or .claude/CLAUDE.md markers + Rules section
codexAGENTS.md or .codex/AGENTS.md markers + Rules section
github_copilot.github/copilot-instructions.md or .github/.github/copilot-instructions.md
genericnone of the above.retornatus/ only (+ hub install still available)

What “native first” means

CapabilityPreference
Rules / instructionsHost rule files
SkillsHost skill directories + skill export
IsolationHost worktree / sandbox / subagents (advisory Boundaries)
ExecutionHost agent runtime

Retornatus records HostExecutionRecord observations; it does not spawn agents.

Active Rule projection

When Rules are activated, bridges refresh so the host sees the same constraints. The instruction block uses begin/end markers and is replaced when its text changes (it is not appended again):

<!-- retornatus-bridge:begin -->
…
<!-- retornatus-bridge:end -->

Active Rules use a separate marked section:

<!-- retornatus-active-rules:begin -->
…
<!-- retornatus-active-rules:end -->

Canonical Rules remain in .retornatus/governance/.

Hub skill

integrate installs progressive disclosure text so the agent learns the construction loop without pasting the entire PRD each turn.

Source template: src/retornatus/infrastructure/environment/hub/SKILL.md.

Remote machines

Detection is the same on a cloud VM. The CLI and git hooks are not in the clone: install them on that machine, leave receipts unsigned, and let the GitHub pull request run verify and the diff gates. See Cloud agents.

integrate --hooks is separate from that bridge. It writes an opt-in session-start hook, a file-edit hook, a Stop hook, and a subagent-stop hook for Claude, Cursor, and Codex. The hooks do not replace CI. See Agent hooks.

← Docs hub Product site →