agent-harnesses · diff

git:20261106.909042d to git:20261107.e294cb4

6 added, 9 removed. Audit A to A.

---

name: agent-harnesses

description: "Operate and configure Claude Code, Copilot, and OpenCode."

license: MIT

metadata:

kind: collection

author: Médéric HURIER (Fmind)

source: github.com/fmind/dot/tree/main/skills/agent-harnesses

created: "2026-09-16"

- updated: "2026-11-06"

+ updated: "2026-11-07"

---

# Agent Harnesses

- Operate the selected coding-agent host without conflating its configuration, permissions, or lifecycle with another host. Antigravity has its own [agy](../agy/SKILL.md) owner.

+ Operate the selected coding-agent host without conflating its configuration, permissions, or lifecycle with another host. Antigravity has its own [agy](../agy/SKILL.md) owner. Claude Code has no guide here: use its built-in help and the [docs index](https://code.claude.com/docs/llms.txt).

## Workflow

- Every host follows these steps; read only the matching guide for its specifics and required resources.

- 1. **Check official docs for version-sensitive features**: read the relevant official page and changelog before relying on flags, settings, models, or feature availability; installed help can omit supported flags, so check the version-specific CLI reference before declaring a feature unavailable. Match the installed version, product surface, account, and platform before applying a recipe, report version gaps, and keep release-specific details upstream. Each guide's operation links cover session recovery, automation, and integration decisions; discover other capabilities from the host's official documentation index.

- 1. **Resolve precedence and permission scope first**: before changing execution behavior; hooks and extensions execute code.

- 1. **Verify** the result, resulting artifacts, and the host's own instruction or skill discovery. Use [agent-project](../agent-project/SKILL.md) for shared instruction layout and [mcp-setup](../mcp-setup/SKILL.md) for MCP registration.

+ 1. **Check the version-specific reference before declaring a feature unavailable**: installed help can omit supported flags.

+ 1. **Resolve precedence and permission scope before changing execution behavior**: hooks and extensions execute code.

+ 1. **Verify** the result and the host's own instruction or skill discovery. Use [agent-project](../agent-project/SKILL.md) for shared instruction layout and [mcp-setup](../mcp-setup/SKILL.md) for MCP registration.

## Task guides

- - [claude](references/claude/GUIDE.md): Claude Code sessions and customization.

- [copilot](references/copilot/GUIDE.md): Copilot sessions and extensions.

- [notifications](references/notifications.md): Diagnose or change managed turn notifications, brain session-context hooks, and their wiring per host.

- [opencode](references/opencode/GUIDE.md): OpenCode sessions and provider configuration.

## Gotchas

- **Edit managed host keys in fmind/dot**: on this workstation, Claude, Copilot, and OpenCode settings are merged from `modify_*` chezmoi templates in `~/.local/share/chezmoi`. A direct edit to a managed key (including through `/config` or a host's settings skill) reverts on `chezmoi apply --force`; unmanaged keys survive. Change the source, preview with `mise run diff` (it excludes encrypted targets), then apply.

- - **Install vendor skills through the policy**: each guide's Official Skills section names the host's sources; install a requested package only through the [vendor-skill policy](../agent-project/references/vendor-skills.md) and retain the existing package manager's ownership.

+ - **Install vendor skills through the policy**: the Copilot and OpenCode guides name each host's sources; install a requested package only through the [vendor-skill policy](../agent-project/references/vendor-skills.md) and retain the existing package manager's ownership.