GNAP: cross-language agent coordination protocol for BotSharp agent networks
Nobody has claimed this yet.
- Dominant language
- C#
- Stars
- 3.1k
- Forks
- 651
- Avg merge
- 15h 2m
- Merged PRs (30d)
- 36
Description
Hi BotSharp team 👋
BotSharp is one of the few serious multi-agent frameworks for .NET — which means it often needs to coordinate with agents in other runtimes (Python, Node, etc.). I wanted to share a protocol designed exactly for this cross-language coordination challenge.
GNAP (Git-Native Agent Protocol) is an open RFC for agent coordination using git as the message bus. Because the protocol is pure JSON files + git, it works identically regardless of what language or runtime the agent uses.
BotSharp-specific value:
BotSharp agents run in .NET but enterprise workflows often involve Python data science agents, Node.js integration agents, or human reviewers. GNAP provides a common coordination layer that works across all of them:
| Agent type | Runtime | GNAP compatible? |
|---|---|---|
| BotSharp agent | .NET/C# | ✅ Any git client |
| Python ML agent | Python | ✅ |
| Claude Code | Node.js | ✅ |
| Human reviewer | Terminal | ✅ |
Integration idea for BotSharp:
BotSharp's IAgentService could have a GNAPBackend implementation that:
- Writes task assignments to
.gnap/tasks/on agent dispatch - Polls via
git pullin the heartbeat loop - Reads results from task JSON on completion
- Provides full git-history audit trail
This would let BotSharp's orchestration layer coordinate .NET agents alongside Python, Node, or human agents without any API contracts or shared infrastructure beyond a git repo.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
The proposal points to IAgentService, .gnap/tasks/, the heartbeat loop, task JSON, and the linked GNAP specification. Start by reviewing those integration points and the GNAP spec; done would require an agreed scope and acceptance criteria for a GNAPBackend, which the issue does not currently define.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- csharp, git, node.js, python
- Domain
- ai, backend-api-design, distributed-systems
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100