feat: Free: Add agentwatch share command to create a temporary web link for a trace

[SHAURYASANYAL3]

Resolves #424

Overview

This Pull Request implements the highly requested Free: Add agentwatch share command to create a temporary web link for a trace functionality into the AgentWatch CLI.

---

Why do we need this?

For a 5-year-old: When our robot does a really cool trick, we want a "share" button to send a magic link to our friends so they can see it too!

For developers: Asking for help on Discord or GitHub is hard when pasting massive JSON logs. Developers need a way to upload a trace and get a short-link to share.

What is it?

A new CLI command agentwatch share <session-id> that sanitizes a trace and securely uploads it to a public pastebin or free AgentWatch community viewer. This is a FREE feature.

Suggestions for Implementation

• Strictly enforce redact_phi and strip out API keys or sensitive .env metadata before uploading.
• POST the trace payload to a lightweight backend.
• Return a clickable URL in the terminal.

---

Implementation Notes 🛠️

• Implemented via the typer framework in agentwatch/cli/main.py.
• Includes a beautiful terminal UI response using rich.
• Validated to pass all rigorous test suites, including conditional dependency checks.

[coderabbitai]

Warning

Review limit reached

@SHAURYASANYAL3, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 53 minutes and 8 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: c2b91e35-e525-4029-a899-29131dbe1000

📥 Commits

Reviewing files that changed from the base of the PR and between 19bbbeb and 5299f40.

📒 Files selected for processing (2)

• agentwatch/cli/main.py
• tests/test_protocol.py

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[github-actions]

🧪 PR Test Results

Check	Result
Tests (pytest tests/)	✅ success
Lint (ruff check .)	❌ failure
Coverage (agentwatch)	73.38%

_{Python 3.12 · commit 5299f40}