feat: agent communication architecture + CLI --prompt flag#97
Open
AgentWrapper wants to merge 1 commit intomainfrom
Open
feat: agent communication architecture + CLI --prompt flag#97AgentWrapper wants to merge 1 commit intomainfrom
AgentWrapper wants to merge 1 commit intomainfrom
Conversation
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 2 potential issues.
Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.
- Add Mailbox class (packages/core/src/mailbox.ts) for structured JSON messaging between orchestrator and sessions - Add --prompt <file> and --prompt-text <text> flags to ao spawn - Add inbox-watcher.sh for message delivery to agents - Add architecture analysis comparing file/socket/queue/tmux approaches - Add integration and migration plan docs Note: Design is still being refined. The mailbox ack mechanism is weak (watcher-level, not agent-level). Agent-native introspection (JSONL for Claude Code) remains the best way to detect agent state. The core value is structured message format, persistent history, and runtime abstraction. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
AgentWrapper
force-pushed
the
feat/agent-communication
branch
from
29b5421 to
ad399a3
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
packages/core/src/mailbox.ts): File-based JSON messaging between orchestrator and sessions, inspired by Claude Code agent teamspackages/cli/src/commands/spawn.ts):ao spawn <project> --prompt <file>and--prompt-text <text>for custom prompts at spawn timescripts/inbox-watcher.sh): Background script that polls inbox and delivers messages to agents via runtimeDesign Status
The architecture is still being refined through discussion. Key takeaways so far:
getActivityState()using native mechanismsruntime.sendMessage()without a full mailbox systemTest plan
ao spawn <project> --prompt /tmp/test.txtao spawn <project> --prompt-text "test prompt"🤖 Generated with Claude Code