OpenBMB / OpenBMB/XAgent

GNAP: git-native task board for XAgent's inner/outer loop multi-agent coordination

Open
#421 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
8.5k
Forks
905
PR merge metrics
No merged PRs in 30d

Description

Proposal: GNAP as a coordination layer for XAgent's PlanAgent + ToolAgent architecture

XAgent's dual-loop architecture (PlanAgent for task decomposition + ToolAgent for execution) is a solid foundation for autonomous task solving. When scaling to multiple XAgent instances working in parallel on decomposed subtasks, you need a coordination protocol.

GNAP (Git-Native Agent Protocol) provides this: a git repo as a shared task board with board/todo/board/doing/board/done/. XAgent's PlanAgent can write subtasks to board/todo/, and multiple ToolAgent instances can claim and execute them in parallel.

Applied to XAgent's task decomposition:

XAgent already breaks complex tasks into subtasks. GNAP makes this coordination explicit and persistent:

board/todo/subtask-1-search-papers.md      ← PlanAgent decomposes
board/todo/subtask-2-analyze-results.md
board/doing/subtask-1-search-papers.md     ← ToolAgent instance 1 claims
board/done/subtask-1-search-papers.md      ← Results + tool logs committed

board/doing/subtask-2-analyze-results.md   ← ToolAgent 2 picks up after subtask 1

XAgent runs in Docker containers — which already have git available. GNAP adds zero infrastructure and the coordination board persists across container restarts. The git history also provides an auditable record of the entire task decomposition and execution trace.

GNAP's simplicity aligns with XAgent's design goal of being general-purpose and extensible — any new tool or agent type can participate in GNAP without SDK changes.

Spec: https://github.com/farol-team/gnap

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading XAgent's PlanAgent and ToolAgent architecture, then review the linked GNAP specification and its board/todo, board/doing, and board/done workflow. Define the integration boundaries and acceptance criteria for persistent multi-agent coordination before identifying implementation files or tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, git, python
Domain
ai, distributed-systems
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.