Skip to content

docs: add Bitchat and XMTP communications subagent docs#2696

Merged
marcusquinn merged 1 commit intomainfrom
feature/bitchat-xmtp-comms
Mar 2, 2026
Merged

docs: add Bitchat and XMTP communications subagent docs#2696
marcusquinn merged 1 commit intomainfrom
feature/bitchat-xmtp-comms

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Mar 2, 2026

Summary

  • Add subagent documentation for Bitchat (decentralized P2P messaging over Bluetooth mesh, no internet required, Noise Protocol encryption)
  • Add subagent documentation for XMTP (Web3 messaging with MLS quantum-resistant encryption, agent SDK, native payments, wallet/DID identity)
  • Update domain index, subagent index, and matterbridge cross-references to include both new protocols

Both docs follow the same structure as existing Matrix and SimpleX docs: YAML frontmatter, Quick Reference with comparison table, Architecture diagram, Protocol details, Installation, Usage, Limitations, Security, Integration with aidevops, and Related links.

Summary by CodeRabbit

  • New Features
    • Added Bitchat, a decentralized peer-to-peer messaging system with Bluetooth mesh support
    • Added XMTP, a Web3 messaging protocol with encryption and offline capabilities
  • Documentation
    • Comprehensive guides for both new communication services including architecture, security, and integration patterns
    • Updated Communications domain index with service references

Add subagent documentation for two new messaging protocols:
- Bitchat: decentralized P2P messaging over Bluetooth mesh (no internet)
- XMTP: Web3 messaging with MLS encryption, agent SDK, native payments

Update domain index, subagent index, and matterbridge cross-references.
@marcusquinn marcusquinn merged commit 26701bd into main Mar 2, 2026
12 of 13 checks passed
@github-actions github-actions bot added the documentation Auto-created from TODO.md tag label Mar 2, 2026
@gemini-code-assist
Copy link

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly expands the communication subagents documentation by introducing detailed guides for Bitchat and XMTP. These additions provide valuable resources for understanding and integrating advanced messaging protocols, covering both internet-independent mesh networking and Web3-native decentralized communication, thereby enhancing the overall scope and utility of the agent documentation.

Highlights

  • New Subagent Documentation: Bitchat: Added comprehensive documentation for Bitchat, a decentralized peer-to-peer messaging protocol that operates over Bluetooth mesh networks without requiring internet connectivity. This includes details on its architecture, Noise Protocol encryption, installation, usage, limitations, security considerations, and potential integration with aidevops.
  • New Subagent Documentation: XMTP: Added comprehensive documentation for XMTP (Extensible Message Transport Protocol), a Web3 messaging protocol featuring quantum-resistant end-to-end encryption (MLS), wallet/DID identity, native payments, and a robust agent SDK. The documentation covers its architecture, protocol details, installation, agent usage, deployment, security, limitations, and integration with aidevops.
  • Index and Cross-Reference Updates: Updated the main AGENTS.md file, matterbridge.md cross-references, and the subagent-index.toon file to properly include and link to the newly added Bitchat and XMTP communication subagent documentation.
Changelog
  • .agents/AGENTS.md
    • Added bitchat.md and xmtp.md to the Communications section.
  • .agents/services/communications/bitchat.md
    • Added new documentation for Bitchat, detailing its architecture, protocol (Noise XX), installation, usage, limitations, security, and integration possibilities.
  • .agents/services/communications/matterbridge.md
    • Added cross-references to the newly documented Bitchat and XMTP communication protocols in the related links section.
  • .agents/services/communications/xmtp.md
    • Added new documentation for XMTP, covering its architecture, protocol (MLS), identity model, content types, installation, agent SDK usage, deployment, security, limitations, and integration with aidevops.
  • .agents/subagent-index.toon
    • Updated the services/communications/ entry to include bitchat and xmtp keywords and descriptions.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 2, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 989ca1f and 7031499.

📒 Files selected for processing (5)
  • .agents/AGENTS.md
  • .agents/services/communications/bitchat.md
  • .agents/services/communications/matterbridge.md
  • .agents/services/communications/xmtp.md
  • .agents/subagent-index.toon

Walkthrough

Added two new communication service documentation files (Bitchat and XMTP) to the agents framework, expanding the communications domain. Updated index entries and added cross-references in related documentation.

Changes

Cohort / File(s) Summary
Documentation Index Updates
.agents/AGENTS.md, .agents/subagent-index.toon
Updated communications domain index entries to reference new Bitchat and XMTP subagents; expanded service description to include Bluetooth mesh and Web3 messaging capabilities.
New Communication Service Documentation
.agents/services/communications/bitchat.md, .agents/services/communications/xmtp.md
Added comprehensive documentation for Bitchat (decentralized P2P messaging over Bluetooth mesh) and XMTP (MLS-based protocol with consent/spam protection); includes architecture, protocol details, installation instructions, usage patterns, and security considerations.
Cross-Reference Updates
.agents/services/communications/matterbridge.md
Added related-document links to newly introduced Bitchat and XMTP documentation files.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested labels

needs-review

Poem

🌐 Two messengers join the communications fold,
Bitchat whispers through Bluetooth's mesh so bold,
XMTP arrives with MLS in tow,
Domain index expanded—let the framework grow! 📡✨

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feature/bitchat-xmtp-comms

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link

github-actions bot commented Mar 2, 2026

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 111 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Mon Mar 2 01:23:27 UTC 2026: Code review monitoring started
Mon Mar 2 01:23:28 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 111

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 111
  • VULNERABILITIES: 0

Generated on: Mon Mar 2 01:23:30 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@sonarqubecloud
Copy link

sonarqubecloud bot commented Mar 2, 2026

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces excellent and thorough documentation for two new communication subagents, Bitchat and XMTP. The new documents are well-structured, providing clear explanations, architectural diagrams, and usage examples. The related index files have also been updated accordingly. My review includes one minor correction to an npm command in the XMTP documentation to ensure the instructions are accurate for users.

```bash
# Create project
mkdir my-agent && cd my-agent
npm init --init-type=module -y

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The npm init command npm init --init-type=module -y is not valid as --init-type is not a recognized flag. To initialize a project that uses ES modules (which is required by the subsequent TypeScript examples), you should first run npm init -y and then add "type": "module" to the package.json file. I've updated the command to reflect a common way of noting this.

Suggested change
npm init --init-type=module -y
npm init -y # And add "type": "module" to package.json

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Auto-created from TODO.md tag

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant