proactive agents update by khaliqgant · Pull Request #29 · AgentWorkforce/agentrelay.com

khaliqgant · 2026-07-19T14:19:19Z

Summary by cubic

Reorganizes the proactive agents docs around the persona.json + agent.ts model, adds a full CLI page, and simplifies Quickstart to one‑click deploy or a single terminal command. Also rebuilds the Agents gallery as a dense list with provider logos, and adds optional Telegram delivery to select agents.

New Features
- Rebuilt Agents gallery: switched the 3‑up grid to a dense list with provider logos, a hoverable trigger summary, and clearer navigation.
- Added provider logos via a new IntegrationLogos component; vendored assets and a sync-integration-logos.sh script (no hotlinking).
- Agent detail pages now show labeled logos for integrations.
- Added CLI docs for agentworkforce covering deploy (--mode, --dry-run, --on-exists), local run (invoke, fixtures, scaffolds), logs, triggers, and teardown.
- Expanded Build guide to the two‑file persona model with skill-based scaffolding (@agent-relay/creating-cloud-persona) and typed triggers vs. behavior.
- Introduction now includes an end‑to‑end “granola-prospect” example with persona and handler code.
- Quickstart supports one‑click Launch from the gallery and a minimal terminal path.
- hn-monitor and spotify-releases: added Telegram as an optional transport (TELEGRAM_CHAT); updated integrations and inputs.
Refactors
- Removed “Deploy and operate” and “Agent patterns”; operations moved into CLI.
- Updated docs nav: Design → Build, Run → CLI.
- Added permanent redirects: /docs/agents/deploy → /docs/agents/cli, /docs/agents/patterns → /docs/agents/build.
- Clarified guidance on declarative wakeups, structured context, and verification (compile, invoke, deploy --dry-run).

^{Written for commit 0c2dc1e. Summary will update on new commits.}

gemini-code-assist · 2026-07-19T14:19:22Z

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

cursor · 2026-07-19T14:19:23Z

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

coderabbitai · 2026-07-19T14:19:57Z

📝 Walkthrough

Walkthrough

The Agents documentation is reorganized around gallery quickstarts, cloud-persona development, and the agentworkforce CLI. Obsolete pattern and deployment pages are removed, and sidebar links are updated accordingly.

Changes

Agents documentation workflow

Layer / File(s)	Summary
Introduction, quickstart, and navigation `web/content/docs/agents/introduction.mdx`, `web/content/docs/agents/quickstart.mdx`, `web/content/docs/agents/patterns.mdx`, `web/content/docs/agents/deploy.mdx`, `web/lib/product-docs-nav.ts`	The introduction now presents relay agents with a complete example; quickstart uses gallery deployment and terminal commands; obsolete patterns and deployment content are removed; navigation points to Build your own and CLI.
Cloud-persona build and CLI workflow `web/content/docs/agents/build.mdx`, `web/content/docs/agents/cli.mdx`	The build guide documents `persona.json`, `agent.ts`, declarative triggers, verification commands, and dry-run deployment. A new CLI page documents authentication, deployment, local execution, operations, and staged promotion guidance.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

AgentWorkforce/agentrelay.com#14: Both PRs update the Agents documentation navigation and agentsSection.

Poem

A rabbit hops through docs anew,
With personas split in two.
Quickstarts bloom and CLIs gleam,
Dry runs guide the deployment stream.
Old pages nap beneath the moon—
New agent paths arrive soon.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Title check	❓ Inconclusive	The title is related to the PR, but it is too generic to clearly identify the main change.	Rename it to something specific like 'Reorganize proactive agents docs around persona.json and agent.ts'.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description check	✅ Passed	The description is broadly aligned with the docs rework and CLI additions in this changeset.

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch proactive-agents

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.}

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7cefe1d170

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-07-19T14:21:37Z

    {
      title: 'Run',
-      items: [{ title: 'Deploy and operate', slug: 'deploy' }],
+      items: [{ title: 'CLI', slug: 'cli' }],


Preserve redirects for the removed agent-doc URLs

Removing the deploy and patterns slugs also removes their MDX files, so existing /docs/agents/deploy and /docs/agents/patterns links now reach the dynamic docs page with no content and return notFound; there is no redirect for either path in the route tree. This breaks previously published navigation targets (the parent quickstart and introduction pages themselves linked to both), as well as any bookmarked or indexed URLs. Add redirects to the appropriate replacement pages (for example, deploy → cli) before deleting the old routes.

Useful? React with 👍 / 👎.

Fixed in 0c2dc1e — added permanent redirects in next.config.mjs: /docs/agents/deploy → /docs/agents/cli (its direct successor) and /docs/agents/patterns → /docs/agents/build, since patterns has no direct replacement and build is the nearest page still covering agent shape. Verified both return 308 to the right destination and that the targets resolve 200.

github-actions · 2026-07-19T14:23:00Z

Preview deployed!

Environment	URL
Web	https://6b63b1f7-agentrelay-web.agent-workforce.workers.dev

This is a Cloudflare Workers preview version of this PR's build.

Replace the 3-up card grid on /agents with a horizontal list. The card artwork was carrying most of the vertical space while saying little, so rows now lead with name + tagline and show which providers each agent touches as logo marks. - Vendor provider logos from Nango's template logos (the same source pear resolves icons from) via scripts/sync-integration-logos.sh, rather than hotlinking on every render. Nango answers 200 with its SPA shell for slugs it has no logo for, so the script sniffs for an SVG root; daytona, gcp, hacker-news, neon, and npm have none and fall back to text chips. granola's logo is a ~525KB SVG wrapping a base64 PNG, so it is unwrapped and downscaled. - Logos sit on a light chip — several marks are solid black and would disappear on the dark surface. - Trigger detail moves to its own reserved line that fades in on hover, so the tagline stays visible and the row never shifts. - Show logos on the agent detail page too, labeled with the provider name. - hn-monitor and spotify-releases declare telegram as an optional transport gated by enabledByInput; reflect that in their integrations and inputs. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

/docs/agents/deploy and /docs/agents/patterns were deleted in this branch without redirects, so bookmarked and indexed links hit notFound. Point deploy at its successor (cli) and patterns at build, which is the nearest page still covering agent shape. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

agents

7cefe1d

chatgpt-codex-connector Bot reviewed Jul 19, 2026

View reviewed changes

khaliqgant and others added 2 commits July 19, 2026 16:53

khaliqgant merged commit 005a147 into main Jul 19, 2026
3 checks passed

khaliqgant deleted the proactive-agents branch July 19, 2026 14:59

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

proactive agents update#29

proactive agents update#29
khaliqgant merged 3 commits into
mainfrom
proactive-agents

khaliqgant commented Jul 19, 2026 •

edited by cubic-dev-ai Bot

Loading

Uh oh!

gemini-code-assist Bot commented Jul 19, 2026

Uh oh!

cursor Bot commented Jul 19, 2026

Uh oh!

coderabbitai Bot commented Jul 19, 2026 •

edited

Loading

Walkthrough

Changes

❌ Failed checks (1 inconclusive)

Uh oh!

chatgpt-codex-connector Bot left a comment

Uh oh!

chatgpt-codex-connector Bot Jul 19, 2026

Uh oh!

khaliqgant Jul 19, 2026

Uh oh!

github-actions Bot commented Jul 19, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

khaliqgant commented Jul 19, 2026 • edited by cubic-dev-ai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by cubic

Uh oh!

gemini-code-assist Bot commented Jul 19, 2026

Uh oh!

cursor Bot commented Jul 19, 2026

Uh oh!

coderabbitai Bot commented Jul 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

❌ Failed checks (1 inconclusive)

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Jul 19, 2026

Choose a reason for hiding this comment

Uh oh!

khaliqgant Jul 19, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Jul 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

khaliqgant commented Jul 19, 2026 •

edited by cubic-dev-ai Bot

Loading

coderabbitai Bot commented Jul 19, 2026 •

edited

Loading

github-actions Bot commented Jul 19, 2026 •

edited

Loading