Skip to content

docs: update README with recent PR features#193

Merged
marcusquinn merged 1 commit intomainfrom
chore/update-readme-recent-prs
Jan 25, 2026
Merged

docs: update README with recent PR features#193
marcusquinn merged 1 commit intomainfrom
chore/update-readme-recent-prs

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Jan 25, 2026

Summary

Updates README.md to reflect features added in PRs #178-#192.

Changes

New Features Documented

Updated Counts

  • MCP servers: 18 → 19 (added Unstract)
  • Subagent files: 536+ → 560+
  • Helper scripts: 141+ → 146+

Performance Documentation

  • Added MCP lazy-loading optimization note (12-24s startup savings)
  • Documented three-tier loading strategy (8 eager, 12 on-demand)

Tool Selection Guide

  • Added WaterCrawl to browser tool selection table
  • Added "Self-hosted crawling" use case

Testing

  • All links valid
  • Markdown formatting correct
  • Badge count updated

Summary by CodeRabbit

  • Documentation
    • Updated MCP server count to 19 active servers.
    • Added new Document Processing tools: LibPDF and Unstract.
    • Expanded Browser Automation toolset with WaterCrawl.
    • Introduced Multi-Tenant Credential Storage configuration section.
    • Added performance optimization guidance including global MCP installation and loading strategy details.
    • Updated tool lists and usage examples.

✏️ Tip: You can customize this high-level summary in your review settings.

- Add WaterCrawl to browser automation tools (7 tools now)
- Add LibPDF and Unstract to document processing section
- Add Cloudron app packaging enhancement note
- Add multi-tenant credential storage documentation
- Update MCP count to 19 (added Unstract)
- Update subagent count to 560+ and scripts to 146+
- Document MCP lazy-loading optimization (12-24s startup savings)
- Add WaterCrawl to tool selection guide

Based on PRs #178-#192
@gemini-code-assist
Copy link

Summary of Changes

Hello @marcusquinn, 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 updates the README.md file to comprehensively reflect recent feature additions and improvements to the project. It integrates new tools for browser automation and document processing, updates various component counts, and provides detailed documentation on performance optimizations and multi-tenant credential management, ensuring the project's documentation remains current and informative.

Highlights

  • New Features Documented: Documentation for WaterCrawl (browser automation), LibPDF (document processing), Unstract (MCP and document processing), Cloudron app packaging enhancements, and Multi-tenant credentials with usage examples has been added.
  • Updated Counts: The reported number of MCP servers increased from 18 to 19, subagent files from 536+ to 560+, helper scripts from 141+ to 146+, and browser automation tools from 6 to 7.
  • Performance Documentation: New notes detail MCP lazy-loading optimization, which saves 12-24 seconds in startup time, and explain the three-tier loading strategy (8 eager, 12 on-demand).
  • Tool Selection Guide Enhancements: WaterCrawl has been added to the browser tool selection table, along with a new 'Self-hosted crawling' use case.
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 Jan 25, 2026

Walkthrough

README.md documentation expanded to reflect framework enhancements: MCP server count increased from 18 to 19, new document processing tools (LibPDF, Unstract) and browser automation tool (WaterCrawl) integrated, Multi-Tenant Credential Storage section added, and performance optimization strategy documented.

Changes

Cohort / File(s) Summary
Documentation Updates
README.md
Incremented active MCP server count to 19; added Document Processing entries (LibPDF, Unstract); expanded Browser Automation toolset with WaterCrawl; introduced Multi-Tenant Credential Storage section with resolution priority and setup guidance; documented three-tier MCP loading strategy (8 eager, 12 on-demand); updated tool comparisons and quick usage examples.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

Poem

🛠️ Nineteen servers strong, tools multiply,
Document processors and crawlers fly,
Credentials flow with tenant care,
DevOps perfection in the air! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: update README with recent PR features' accurately describes the main change—documentation updates to README reflecting features from recent PRs #178#192.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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.

@sonarqubecloud
Copy link

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 does a great job of updating the README with features from recent pull requests. The documentation for new tools like WaterCrawl, LibPDF, and Unstract is clear, and the new section on Multi-Tenant Credential Storage is a valuable addition. All the counters for MCPs, subagents, and scripts have been updated accordingly. I found one minor inconsistency in the MCP counts in the performance optimization section, which I've commented on. Otherwise, the changes look good.

- **Global** - Tools always available (loaded into every session)
- **Per-agent** - Tools disabled globally, enabled per-agent via config (zero context overhead when unused)

**Performance optimization:** MCP packages are installed globally via `bun install -g` for instant startup (~0.1s vs 2-3s with `npx`). The framework uses a three-tier loading strategy: 8 MCPs load eagerly at startup, 12 MCPs load on-demand when their subagent is invoked. This reduces OpenCode startup time by 12-24 seconds.

Choose a reason for hiding this comment

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

medium

There's a discrepancy in the MCP counts. This note mentions a total of 20 MCPs (8 eager + 12 on-demand). However, the badge, heading, and table above all indicate a total of 19 MCPs. Additionally, the table lists 3 'Global' (eager) and 16 'Per-agent' (on-demand) MCPs, which doesn't align with the 8/12 split mentioned here. Please correct these numbers for consistency.

@github-actions
Copy link

🔍 Code Quality Report

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

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

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Jan 25 02:38:35 UTC 2026: Code review monitoring started
Sun Jan 25 02:38:36 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 481
Sun Jan 25 02:38:36 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sun Jan 25 02:38:38 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 481
  • VULNERABILITIES: 0

Generated on: Sun Jan 25 02:39:51 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@augmentcode
Copy link

augmentcode bot commented Jan 25, 2026

🤖 Augment PR Summary

Summary: Updates README.md to reflect features and tooling added across recent PRs (#178#192).

Changes:

  • Bumps documented counts (MCP servers to 19, subagents to 560+, helper scripts to 146+).
  • Documents new tools: WaterCrawl (browser automation/crawling) and a new Document Processing section (LibPDF + Unstract).
  • Enhances hosting/docs notes (e.g., Cloudron packaging guide) and expands MCP performance/lazy-loading documentation.
  • Adds a multi-tenant credential storage quickstart with usage examples and a link to the full guide.

🤖 Was this summary useful? React with 👍 or 👎

Copy link

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

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

Review completed. 2 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

- **Global** - Tools always available (loaded into every session)
- **Per-agent** - Tools disabled globally, enabled per-agent via config (zero context overhead when unused)

**Performance optimization:** MCP packages are installed globally via `bun install -g` for instant startup (~0.1s vs 2-3s with `npx`). The framework uses a three-tier loading strategy: 8 MCPs load eagerly at startup, 12 MCPs load on-demand when their subagent is invoked. This reduces OpenCode startup time by 12-24 seconds.
Copy link

Choose a reason for hiding this comment

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

This sentence says “three-tier loading strategy” but only describes eager vs on-demand, and the “12 MCPs load on-demand” count appears to be out of sync with the current loading policy in .agent/scripts/generate-opencode-agents.sh (8 eager / 13 lazy). Consider reconciling the wording/numbers so readers don’t rely on stale counts when configuring MCP loading.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

echo "client-acme" > .aidevops-tenant

# Export for scripts
eval $(credential-helper.sh export)
Copy link

Choose a reason for hiding this comment

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

In this snippet, eval $(credential-helper.sh export) collapses newlines into spaces, which can change how the multiple export ... lines are interpreted (e.g., potentially exporting a stray variable named export). Consider ensuring the README example preserves the intended multi-line export semantics for reliability.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@README.md`:
- Line 709: The numbers in README.md are inconsistent: the line stating "8 MCPs
load eagerly at startup, 12 MCPs load on-demand" totals 20 but the badge/header
claims "19 active MCPs"; verify the actual count in the MCP table and update to
be consistent by either changing the badge/header to "20 active MCPs" or
adjusting the loading strategy to "8 + 11" or "7 + 12" as appropriate; ensure
the strings "8 MCPs", "12 MCPs", "19 active MCPs" and the MCP table entries are
all updated to match the verified total.

- **Global** - Tools always available (loaded into every session)
- **Per-agent** - Tools disabled globally, enabled per-agent via config (zero context overhead when unused)

**Performance optimization:** MCP packages are installed globally via `bun install -g` for instant startup (~0.1s vs 2-3s with `npx`). The framework uses a three-tier loading strategy: 8 MCPs load eagerly at startup, 12 MCPs load on-demand when their subagent is invoked. This reduces OpenCode startup time by 12-24 seconds.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Math inconsistency: 8 + 12 ≠ 19.

The performance optimization note states "8 MCPs load eagerly at startup, 12 MCPs load on-demand" which totals 20, but the badge and header claim 19 active MCPs. Either the loading strategy numbers are wrong, or the total count is wrong.

🔢 Verify and correct the counts

One of these needs correction:

  1. Badge/header should say 20, not 19
  2. Loading strategy should be 8 + 11 = 19 or 7 + 12 = 19

Check the actual MCP table count and update accordingly.

🤖 Prompt for AI Agents
In `@README.md` at line 709, The numbers in README.md are inconsistent: the line
stating "8 MCPs load eagerly at startup, 12 MCPs load on-demand" totals 20 but
the badge/header claims "19 active MCPs"; verify the actual count in the MCP
table and update to be consistent by either changing the badge/header to "20
active MCPs" or adjusting the loading strategy to "8 + 11" or "7 + 12" as
appropriate; ensure the strings "8 MCPs", "12 MCPs", "19 active MCPs" and the
MCP table entries are all updated to match the verified total.

@marcusquinn marcusquinn merged commit 9eac13a into main Jan 25, 2026
19 of 20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant