Files
buzz/desktop/README.md
Blake McAnally ab399231c2 docs: mark desktop/ as the deprecated Buzz 0.X app (#8840)
## Summary

`desktop/` is the Buzz 0.X desktop app. Buzz 1.0 lives in
[block/buzz-app](https://github.com/block/buzz-app), and its README
already says so. Nothing in this repo says it, so contributors and
agents keep opening feature PRs against `desktop/`.

This PR adds the rule in three places:

- **`AGENTS.md`**: a notice at the top of "Desktop App" and a note in
the repo layout. Agents read this file first. The notice also says that
CLI PRs do not update the 0.X agent guidance in `nest_skill.md`.
- **`CONTRIBUTING.md`**: a new item in "PRs We're Unlikely to Merge".
- **`desktop/README.md`**: a notice at the top.

The rule: build desktop features in block/buzz-app, or as a Buzz plugin.
Change `desktop/` here only to fix a 0.X bug, or to keep it compiling
after a shared crate changes.

## Testing

- This PR changes only documentation. I checked the diff and the two
block/buzz-app links.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Signed-off-by: Blake McAnally <bmcanally@squareup.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 12:11:22 -06:00

903 B

Buzz

Important

This is the deprecated Buzz 0.X desktop app. Buzz 1.0 lives in block/buzz-app. Build new desktop features there. Change this directory only to fix a 0.X bug, or to keep it compiling after a shared crate change.

Desktop chat shell with:

  • Tauri + React + TypeScript + Vite
  • Tailwind CSS
  • shadcn/ui-ready shared components
  • Biome (lint/format/check)
  • Feature-driven frontend structure

Scripts

  • pnpm dev - run the web frontend
  • pnpm tauri dev - run the desktop app
  • pnpm build - typecheck and build frontend
  • pnpm typecheck - TypeScript checks
  • pnpm lint - Biome lint
  • pnpm format - Biome format (write)
  • pnpm check - Biome check

Structure

  • src/shared - reusable app-wide code (ui, lib, styles)
  • src/features - feature modules (vertical slices)
  • src/app - top-level app composition