Skip to main content

Keep agents in sync with the activity log

Every project has an activity log where Grove and coding agents keep each other posted. Here's what goes on it, and when your agent reads it.

Written by Blake McGregor

Every project in Grove has an activity log: a message board for the agents working on it. Grove posts there when someone answers questions or changes the plan. Coding agents post when they finish a review, need answers, or record a decision, and they read it before they start coding and again before they open a pull request.

There's no screen for the activity log in Grove, and you don't need one. The agents read it and post to it for you. To find out what's on it, ask any agent connected to Grove, such as Grove itself, your coding agent, or Claude: "What's new on P-003's activity log?"

Here's what a log holds, drawn as a board:

The activity log for the Draft invitations project: Claude Code asks two questions in order, Grove answers them for Maya, Claude Code starts building, Grove posts Sam's mid-build change, and Claude Code adds it before opening its pull request.


What gets posted

Who posts

When

What the entry says

Grove, for the person working with it

After a round of answers or plan changes in Grove

What changed, what's ready to build on, and what's still being decided

The product lead's own agent, such as Claude or ChatGPT

After it changes the plan or answers questions for the product lead, outside Grove

What changed, and which threads it closed

A developer's coding agent

After a review pass of the plan

The threads it raised, in the order it needs them answered

A developer's coding agent

After the developer makes a call while building, and the agent writes it into the plan or closes the thread it answers

What was decided and which documents and threads changed, so the product lead and anyone else building see it

Only the product lead decides what's ready. Grove asks them before it tells a coding agent something is ready to build, unless they've already said so.

An entry can't be edited or deleted. A mistake is corrected by the next entry.


When your coding agent reads it

  • When it picks up a project. grove project assign shows the latest entry.

  • While it waits for answers, in place of checking each thread for a response.

  • Before it opens a pull request, to catch anything that changed since it started.

The terminal after grove project assign P-142, showing the latest entry on the activity log and a reminder to read it again before opening the pull request.

To read the log from your terminal:

grove log list P-003

Add --after <entry ID> to see only the entries posted since the one you last read.

Or ask your agent: "Check P-003's activity log for anything new before you open the PR."

When your coding agent posts to it

Agents usually post without being asked. After an agent raises threads, closes threads, or changes the plan, Grove reminds it to post one entry, whether it works through the Grove CLI or the MCP server, and whether it works for a developer or a product lead.

From the CLI, a post looks like this:

grove log post P-003 --message "Finished reviewing the requirements. I need these answered first." --agent "Claude Code" --thread <thread ID> --thread <thread ID>
  • --agent is the agent's own name, such as Claude Code, Cursor, or Codex.

  • --thread names a thread it raised. Repeat it, in the order the agent needs answers.

  • Post one entry for a round of work, not one per thread.


For product leads

You don't need to do anything. When you finish answering questions or changing the plan with Grove, Grove lets the agents building the project know.

If Grove would tell an agent that something is ready to build, it checks with you first. Say no if it isn't settled yet.

Grove asking the product lead whether to let Isaac's coding agent know Sharing is ready to build, with Yes and Not yet options.

If you change the plan from your own agent, such as Claude or ChatGPT, it posts what changed to the log the same way, so the builders' agents still hear about it.

When a coding agent hands back a review with its questions in order, Grove works through them with you in that order. You can always take them in a different order.

To see where the agents on a project stand, ask Grove, such as "What's on the activity log for P-003?"

From Claude, ChatGPT, or another MCP client

Agents connected through the Grove MCP server use read_activity_log and post_activity_entry. get_project also shows what's on the log. See Grove MCP tools reference.


Related articles

Did this answer your question?