agent-harnesses

Files (9)

• SKILL.md
• GUIDE.md · references/claude/
• GUIDE.md · references/codex/
• GUIDE.md · references/copilot/
• GUIDE.md · references/grok/
• features.md · references/grok/references/
• notifications.md · references/
• GUIDE.md · references/opencode/
• features.md · references/opencode/references/

SKILL.md (first lines)

# 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.

## 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.

## Task guides

<!-- guides:start -->

- [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.

<!-- guides:end -->

## 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 `chezmoi diff`, 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.

From fmind/dot, MIT.

More from fmind/dot