diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 0000000..426a020 --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,30 @@ +name: Deploy to GitHub Pages +on: + push: + branches: [main] + paths: [docs/site/**] + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: true + +jobs: + deploy: + runs-on: ubuntu-latest + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - uses: actions/checkout@v4 + - uses: actions/configure-pages@v5 + - uses: actions/upload-pages-artifact@v3 + with: + path: docs/site + - id: deployment + uses: actions/deploy-pages@v4 diff --git a/docs/site/index.html b/docs/site/index.html new file mode 100644 index 0000000..5a7c041 --- /dev/null +++ b/docs/site/index.html @@ -0,0 +1,430 @@ + + + + + +dotagents - one repo for all your coding agents + + + + +
+
+ + +
open source
+

One repo for all your coding agents.

+

+ dotagents keeps skills, MCP servers, hooks, and agent roles in one + ~/.agents directory and syncs them into native formats for every harness you use. + Add once, available everywhere. +

+ + +
+
+
+
+
+ ~/.agents +
+ 
$ dotagents status
+
+~/.agents synced from github.com/yourconscience/dotagents
+
+claude-code  synced   plugin delivery   11 skills  2 MCP  4 hooks
+codex        synced   27 skills  4 agent roles  2 MCP  5 hooks
+hermes       synced   27 skills  2 MCP  13 hooks
+droid        synced   27 skills  4 agent roles  2 MCP  5 hooks
+pi           synced   27 skills
+
+ + +
+

Supported harnesses

+

Managed harnesses get full sync: skills, MCP, hooks, roles. Compatibility harnesses get documented paths.

+ +
+ +
+
+ + + +
+
Claude Code
+
managed
+
+ +
+
+ + + +
+
Codex
+
managed
+
+ +
+
+ + + +
+
Factory Droid
+
managed
+
+ +
+
+ + + + + + + + +
+
Hermes
+
managed
+
+ +
+
+ + π + +
+
Pi
+
managed
+
+ +
+
+ + + + + +
+
Amp
+
compat
+
+ +
+
+ + + + +
+
OpenCode
+
compat
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
OpenClaw
+
compat
+
+
+
+ + +
+

Get started

+

Two paths. Plugin if you just want skills in Claude Code. CLI if you want the full sync layer.

+ +
+
+
Plugin
+

Claude Code marketplace

+

Install portable skills directly. No CLI, no clone.

+ 
> /plugin marketplace add yourconscience/dotagents
+> /plugin install tech-search@yourconscience
+
+ +
+
CLI
+

Full setup

+

Clone, install, sync. All detected agents get your skills, MCP, hooks, and roles.

+ 
$ git clone https://github.com/yourconscience/dotagents ~/.agents
+$ go install github.com/yourconscience/dotagents/cmd/dotagents@latest
+$ dotagents setup
+
+

Then add a skill and sync it everywhere:

+ 
$ mkdir skills/my-skill && cat > skills/my-skill/SKILL.md
+$ dotagents sync
+synced 28 skills to 5 harnesses
+
+
+
+
+ + +
+

What syncs

+

Not just skills. The full config surface that fragments across agents.

+ +
+

Sync surface by harness

+
+ + + + + + + + + +
HarnessSkillsAgent rolesMCPHooksRoot instructions
Claude CodeyesyesyesyesCLAUDE.md shim
CodexyesyesyesyesAGENTS.md
Factory DroidyesyesyesyesAGENTS link
Hermesyes--yesyesnative ctx
Piyes--yes--OMP ctx
+
+
+
+ + +
+

Alternatives

+

Other tools solve parts of this. dotagents covers the full surface across the post-IDE agent stack.

+ +
+

Comparison

+
+ + + + + + + + + + + + +
dotagentsskillsharevsyncagents-cli
Skills syncyesyesyesyes
MCP syncyesnoyesyes
Hooks syncyesnonono
Agent rolesyesnoyesno
Plugin catalogyesnonono
Skill pinningyesyesnono
Security audityesyesnono
Private overlayyesnonono
+
+
+
+ + + +
+ +