Skip to content
All guides

GitHub Copilot + agentdocs

Manage copilot-instructions.md as a single living doc your whole team edits. Pull into every repo.

1 min readGuide

Set up tracking

agentdoc init
agentdoc track .github/copilot-instructions.md --slug copilot-instructions
agentdoc push

Your instructions live at @yourteam/copilot-instructions, edited by the whole team with full version history.

Pull into any repo

agentdoc init
mkdir -p .github
agentdoc track .github/copilot-instructions.md --slug copilot-instructions
agentdoc pull

Keep it current

  • agentdoc status → shows synced / behind / modified.
  • agentdoc pull → latest in place.
  • agentdoc push → push local improvements back.
  • agentdoc history copilot-instructions → see every change.
  • agentdoc watch .github/copilot-instructions.md copilot-instructions → auto-push on save.

Layer org + project instructions

Pull the org-wide base and concatenate a project-local file on setup:

copilot-instructions:
	agentdoc pull .github/copilot-base.md
	cat .github/copilot-base.md .github/copilot-local.md > .github/copilot-instructions.md

One doc, many tools

The same AgentDoc can feed Copilot, Cursor, Claude Code, and Windsurf — all markdown. See the Team Sharing guide.

Quick start

agentdoc init && \
  agentdoc track .github/copilot-instructions.md --slug copilot-instructions && \
  agentdoc push