Skip to content

Agent Commons v0.1.0

Choose a tag to compare

View all tags
@dqsjqian dqsjqian released this 28 May 06:22
· 3 commits to main since this release
v0.1.0
c815845

Initial public release.

Agent Commons is a local-first, plaintext-only shared memory protocol for AI agents. Multiple agents (Claude Code, Cursor, WorkBuddy, CodeBuddy, OpenClaw, etc.) on the same machine share a central directory at ~/.agent-commons/ so they don't forget what each other learned.

What's in this release

  • Protocol decoupling: ONBOARDING.md (one-time joining flow) is separate from skills/SKILL.md (recurring runtime capability). Agents read onboarding once; the runtime skill carries the day-to-day capabilities forward.
  • Discover-first install: agents must locate their own user-extensible / 'custom skills' directory before installing — not a built-in tier (where files would land but never trigger), and not another agent's directory.
  • Closed-loop trigger test: install ≠ done. The runtime must actually invoke / list / describe the skill before the install is considered complete. Adaptive fallback ladder symlink → copy → readonly walks itself, only asking for help if all three tiers fail.
  • Mirror-correct update strategy: Tier 2 (copy) agents must use rsync --delete / Robocopy /MIR / staged-tempdir-and-atomic-swap to handle adds, modifies, deletes, AND renames. Plain cp -R is a protocol violation — it leaves ghost files. Post-update, the trigger self-test runs again.
  • Cross-platform installer: install.sh (POSIX) + install.ps1 (Windows PowerShell, with UTF-8 BOM + chcp 65001 + UTF-8 byte-array Chinese to defeat PS 5.1 mojibake).

Install

macOS / Linux / WSL / Git Bash:

curl -fsSL https://raw.githubusercontent.com/dqsjqian/agent-commons/main/install.sh | bash

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/dqsjqian/agent-commons/main/install.ps1 | iex

Then tell any AI agent:

Read ~/.agent-commons/ONBOARDING.md and join Agent Commons.

License: MIT.

Assets 2
Loading