Skip to content

feat(agents): open agent imports from the CLI - #2624

Open
bartlomein wants to merge 1 commit into
block:mainfrom
bartlomein:fizz/agent-import
Open

feat(agents): open agent imports from the CLI#2624
bartlomein wants to merge 1 commit into
block:mainfrom
bartlomein:fizz/agent-import

Conversation

@bartlomein

Copy link
Copy Markdown

Why

Beekeep.sh is a public, reviewed registry of Buzz agents. Its CLI can download and verify an approved agent snapshot, but users still need a safe handoff into Buzz Desktop.

This adds that handoff. Beekeep and other native tools can ask Buzz to open its existing import review without silently creating an agent. The user remains in control and must explicitly click Import.

What changed

  • Add buzz agents import --file <snapshot> as a local-only CLI command.
  • Add a versioned buzz://agent-import?v=1&file=... Desktop deep link.
  • Focus Buzz, navigate to My Agents, and open the existing snapshot review automatically.
  • Add bounded and expandable instruction review, validation, tests, and integration documentation.

Safety

  • The handoff accepts only absolute local .agent.json or .agent.png files within documented size limits.
  • Buzz Desktop independently validates the snapshot before showing it.
  • Opening the link never creates an agent; creation still requires an explicit Import click.

Screenshots

Screenshot 2026-07-23 at 3 49 58 PM Screenshot 2026-07-23 at 3 47 10 PM

Testing

  • cargo test -p buzz-cli
  • ./bin/just desktop-tauri-test
  • Focused Playwright agent-import deep-link test
  • Manual v=1 deep-link review in the dev app
  • ./bin/just ci and git diff --check

@bartlomein
bartlomein requested a review from a team as a code owner July 23, 2026 21:10
Signed-off-by: Bart Tyrpien <bartlomein123@gmail.com>
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