You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+5-2Lines changed: 5 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
Dotfiles for your AI agents.
4
4
5
-
One private `~/.agents` git repository holds your skills, MCP servers, hooks, and agent roles. The `dotagents` CLI syncs each of those into the native format of every coding agent you use — Claude Code, Codex, Factory Droid, Hermes, Pi — and follows you across machines the way dotfiles do. External skills are commit-pinned and audited before any agent loads them.
5
+
One private `~/.agents` git repository holds your skills, MCP servers, hooks, and agent roles. The `dotagents` CLI syncs each of those into the native format of every coding agent you use — Claude Code, Codex, Factory Droid, Hermes, OpenCode, Pi — and follows you across machines the way dotfiles do. External skills are commit-pinned and audited before any agent loads them.
@@ -75,11 +75,14 @@ Exactly four surfaces, each rendered into the harness's own format — dotagents
75
75
| Codex | yes | yes | yes | yes |
76
76
| Factory Droid | yes | yes | yes | yes |
77
77
| Hermes | yes | -- | yes | yes |
78
+
| OpenCode | yes† | yes | yes | -- |
78
79
| Pi*| yes | --*| --*| -- |
79
80
80
81
\* Vanilla [pi](https://github.com/earendil-works/pi) is skills-only by design. If you run the OMP fork instead, dotagents detects it separately and additionally manages roles and MCP servers there — the two never conflict.
81
82
82
-
Amp, OpenCode, and OpenClaw can read the repo's skills through standard conventions but are not managed; a surface gets a "yes" above only after its native behavior is verified end to end.
83
+
† OpenCode reads `~/.agents/skills/` natively, so dotagents delivers skills without a mirror when the config root is `~/.agents`; a custom config root mirrors into `~/.config/opencode/skills/` like other harnesses. OpenCode's only hook surface is a JS plugin API, so hooks stay unsupported.
84
+
85
+
Amp and OpenClaw can read the repo's skills through standard conventions but are not managed; a surface gets a "yes" above only after its native behavior is verified end to end.
<divclass="mini" style="--accent: var(--gold)"><divclass="name"><spanclass="mark">⚡</span>Amp</div><p>CLI support remains for migration and one-off local configs. Not a canonical default target.</p></div>
337
343
<divclass="mini" style="--accent: var(--red)"><divclass="name"><spanclass="mark">⟠</span>OpenClaw</div><p>Needs an owner and verified config surface before dotagents treats it as managed.</p></div>
338
-
<divclass="mini" style="--accent: var(--blue)"><divclass="name"><spanclass="mark">{ }</span>OpenCode</div><p>Compatibility research only. Add support when there is a real daily workflow to preserve.</p></div>
<title>dotagents - public CLI for your private agent config</title>
7
-
<metaname="description" content="Public Go CLI that syncs skills, MCP servers, hooks, and roles from your private ~/.agents repository into Claude Code, Codex, Droid, Hermes, and Pi.">
7
+
<metaname="description" content="Public Go CLI that syncs skills, MCP servers, hooks, and roles from your private ~/.agents repository into Claude Code, Codex, Droid, Hermes, OpenCode, and Pi.">
<pclass="section-sub" style="margin-top:10px">* Vanilla pi is skills-only by design; on the OMP fork dotagents additionally manages agent roles and MCP servers.</p>
394
+
<pclass="section-sub" style="margin-top:10px">* Vanilla pi is skills-only by design; on the OMP fork dotagents additionally manages agent roles and MCP servers. † OpenCode reads <code>~/.agents/skills/</code> natively, so skills need no mirror when the config root is <code>~/.agents</code>; hooks are a JS plugin surface only.</p>
394
395
</div>
395
396
</section>
396
397
397
398
<!-- Landscape -->
398
399
<section>
399
400
<h2>Landscape</h2>
400
-
<pclass="section-sub">Project-level generators win on tool breadth. dotagents is user-level: one private repo that follows you across machines, five harnesses deep, with pinned and audited external skills.</p>
401
+
<pclass="section-sub">Project-level generators win on tool breadth. dotagents is user-level: one private repo that follows you across machines, six harnesses deep, with pinned and audited external skills.</p>
0 commit comments