Skip to content

docs: update README with recent PR features #193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
marcusquinn merged 1 commit into from
Jan 25, 2026
Merged

docs: update README with recent PR features #193

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 47 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ The result: AI agents that work *with* your development process, not around it.
[![Services Supported](https://img.shields.io/badge/Services%20Supported-30+-brightgreen.svg)](#comprehensive-service-coverage)
[![AGENTS.md](https://img.shields.io/badge/AGENTS.md-Compliant-blue.svg)](https://agents.md/)
[![AI Optimized](https://img.shields.io/badge/AI%20Optimized-Yes-brightgreen.svg)](https://github.com/marcusquinn/aidevops/blob/main/AGENTS.md)
[![MCP Servers](https://img.shields.io/badge/MCP%20Servers-18-orange.svg)](#mcp-integrations)
[![MCP Servers](https://img.shields.io/badge/MCP%20Servers-19-orange.svg)](#mcp-integrations)
[![API Integrations](https://img.shields.io/badge/API%20Integrations-30+-blue.svg)](#comprehensive-service-coverage)

<!-- AI-CONTEXT-START -->
Expand All @@ -92,8 +92,8 @@ The result: AI agents that work *with* your development process, not around it.
### Agent Structure

- 18 primary agents (Plan+, Build+, SEO, WordPress, etc.)
- 536+ subagent markdown files organized by domain
- 141+ helper scripts in `.agent/scripts/`
- 560+ subagent markdown files organized by domain
- 146+ helper scripts in `.agent/scripts/`
- 41 slash commands for common workflows

<!-- AI-CONTEXT-END -->
Expand Down Expand Up @@ -584,7 +584,7 @@ The setup script offers to install these tools automatically.
- **[Hetzner Cloud](https://www.hetzner.com/cloud)**: VPS servers, networking, load balancers
- **[Closte](https://closte.com/)**: Managed hosting, application deployment
- **[Coolify](https://coolify.io/)** *Enhanced with CLI*: Self-hosted PaaS with CLI integration
- **[Cloudron](https://www.cloudron.io/)**: Server and app management platform
- **[Cloudron](https://www.cloudron.io/)** *Enhanced with packaging guide*: Server and app management platform with custom app packaging support
- **[Vercel](https://vercel.com/)** *Enhanced with CLI*: Modern web deployment platform with CLI integration
- **[AWS](https://aws.amazon.com/)**: Cloud infrastructure support via standard protocols
- **[DigitalOcean](https://www.digitalocean.com/)**: Cloud infrastructure support via standard protocols
Expand Down Expand Up @@ -646,6 +646,11 @@ The setup script offers to install these tools automatically.
- **[DSPyGround](https://dspyground.com/)**: Interactive playground for prompt optimization
- **[TOON Format](https://github.com/marcusquinn/aidevops/blob/main/.agent/toon-format.md)**: Token-Oriented Object Notation - 20-60% token reduction for LLM prompts

### **Document Processing**

- **[LibPDF](https://libpdf.dev/)**: PDF form filling, digital signatures (PAdES B-B/T/LT/LTA), encryption, merge/split, text extraction
- **[Unstract](https://github.com/Zipstack/unstract)**: LLM-powered structured data extraction from unstructured documents (PDF, images, DOCX)

### **Communications**

- **[Twilio](https://www.twilio.com/)**: SMS, voice calls, WhatsApp, phone verification (Verify API), call recording & transcription
Expand All @@ -671,7 +676,7 @@ The setup script offers to install these tools automatically.

**Model Context Protocol servers for real-time AI assistant integration.** The framework configures these MCPs primarily for **[OpenCode](https://opencode.ai/)** (recommended). Configuration support is also available for 17 other AI assistants including Cursor, Claude Code/Desktop, Windsurf, Continue.dev, Cody, Zed, GitHub Copilot, Kilo Code, Kiro, AntiGravity, Gemini CLI, Droid, Warp AI, Aider, and Qwen.

### **All Supported MCPs (18 active)**
### **All Supported MCPs (19 active)**

MCP packages are installed globally via `bun install -g` for instant startup (no `npx` registry lookups). Run `setup.sh` or `aidevops update-tools` to update to latest versions.

Expand All @@ -695,11 +700,14 @@ MCP packages are installed globally via `bun install -g` for instant startup (no
| [Repomix](https://github.com/yamadashy/repomix) | Codebase packing for AI context | Per-agent | No |
| [Sentry](https://sentry.io/) | Error tracking | Per-agent | Yes |
| [Socket](https://socket.dev/) | Dependency security | Per-agent | No |
| [Unstract](https://github.com/Zipstack/unstract) | Document data extraction | Per-agent | Yes |

**Tier explanation:**
- **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

@gemini-code-assist gemini-code-assist bot Jan 25, 2026

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.

Copy link

@augmentcode augmentcode bot Jan 25, 2026

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 👎

Copy link
Contributor

@coderabbitai coderabbitai bot Jan 25, 2026

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.


### **SEO Integrations (curl subagents - no MCP overhead)**

These use direct API calls via curl, avoiding MCP server startup entirely:
Expand All @@ -721,12 +729,13 @@ These use direct API calls via curl, avoiding MCP server startup entirely:
- [Context7](https://context7.com/) - Real-time documentation access for thousands of libraries
- [Repomix](https://github.com/yamadashy/repomix) - Pack codebases into AI-friendly context

**Browser Automation** (6 tools + anti-detect stack, [benchmarked](#browser-automation)):
**Browser Automation** (7 tools + anti-detect stack, [benchmarked](#browser-automation)):

- [Playwright](https://playwright.dev/) - Fastest engine (0.9s form fill), parallel contexts, extensions, proxy (auto-installed)
- [dev-browser](https://github.com/nicholasgriffintn/dev-browser) - Persistent profile, stays logged in, ARIA snapshots, pairs with DevTools
- [agent-browser](https://github.com/vercel-labs/agent-browser) - CLI/CI/CD, `--session` parallel, ref-based element targeting
- [Crawl4AI](https://github.com/unclecode/crawl4ai) - Bulk extraction, `arun_many` parallel (1.7x), LLM-ready markdown
- [WaterCrawl](https://github.com/watercrawl/watercrawl) - Self-hosted crawling with web search, sitemap generation, JS rendering, proxy support
- [Playwriter](https://github.com/nicholasgriffintn/playwriter) - Your browser's extensions/passwords/proxy, already unlocked
- [Stagehand](https://github.com/browserbase/stagehand) - Natural language automation, self-healing selectors
- [Chrome DevTools MCP](https://github.com/nicholasgriffintn/chrome-devtools-mcp) - Companion: Lighthouse, network throttling, CSS coverage (pairs with any tool)
Expand Down Expand Up @@ -774,6 +783,11 @@ These use direct API calls via curl, avoiding MCP server startup entirely:
- [QuickFile](https://github.com/marcusquinn/quickfile-mcp) - Accounting API integration (MCP)
- [Amazon Order History](https://github.com/marcusquinn/amazon-order-history-csv-download-mcp) - Order data extraction (MCP)

**Document Processing:**

- [LibPDF](https://libpdf.dev/) - PDF form filling, digital signatures, encryption, merge/split (via helper script)
- [Unstract](https://github.com/Zipstack/unstract) - LLM-powered structured data extraction from PDFs, images, DOCX (MCP)

### **Quick Setup**

```bash
Expand Down Expand Up @@ -817,7 +831,7 @@ These catch formatting and syntax issues during editing, reducing preflight/post

## **Browser Automation**

6 browser tools + anti-detect stack, benchmarked and integrated for AI-assisted web automation, dev testing, data extraction, and bot detection evasion. Agents automatically select the optimal tool based on task requirements.
7 browser tools + anti-detect stack, benchmarked and integrated for AI-assisted web automation, dev testing, data extraction, and bot detection evasion. Agents automatically select the optimal tool based on task requirements.

### Performance Benchmarks

Expand Down Expand Up @@ -852,6 +866,7 @@ Tested on macOS ARM64, all headless, warm daemon:
| **Stay logged in** | dev-browser | Profile persists across restarts |
| **Your extensions/passwords** | Playwriter | Already unlocked in your browser |
| **Bulk extraction** | Crawl4AI | Purpose-built, parallel, LLM-ready output |
| **Self-hosted crawling** | WaterCrawl | Docker deployment, web search, sitemap generation |
| **CLI/CI/CD** | agent-browser | No server needed, `--session` isolation |
| **Unknown pages** | Stagehand | Natural language, self-healing |
| **Performance debugging** | Chrome DevTools MCP | Companion tool, pairs with any browser |
Expand Down Expand Up @@ -1821,6 +1836,31 @@ bash .agent/scripts/setup-mcp-integrations.sh all
- Set proper file permissions (600 for configs)
- Regular key rotation and access audits

### Multi-Tenant Credential Storage

Manage multiple accounts/clients per service with isolated credential sets:

```bash
# Create a new tenant
credential-helper.sh create client-acme

# Switch active tenant
credential-helper.sh switch client-acme

# Set credentials for current tenant
credential-helper.sh set GITHUB_TOKEN ghp_xxx

# Per-project override (gitignored)
echo "client-acme" > .aidevops-tenant

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

@augmentcode augmentcode bot Jan 25, 2026

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 👎

```

**Resolution priority:** Project `.aidevops-tenant` → Global active tenant → Default

See `.agent/tools/credentials/multi-tenant.md` for complete documentation.

**Quality Assurance:**

- Multi-platform analysis (SonarCloud, CodeFactor, Codacy, CodeRabbit, Qlty, Snyk, Gemini Code Assist)
Expand Down
Loading