Files
Rahul Tarak 7477aa9566 feat(cli): scaffold native UI sidecar (#3418)
## Summary
- Scaffold a macOS Swift `composio-native-ui` sidecar with a borderless
floating native overlay and Metal-driven pulsing/liquid-glass visual
treatment.
- Add a hidden/dev `composio dev native-ui` command that spawns the
bundled sidecar from CLI local-tool assets.
- Wire the sidecar into local-tool binary build scripts and CLI binary
release packaging checks for Darwin artifacts.

## Tests
- `pnpm install --frozen-lockfile`
- `pnpm typecheck`
- `pnpm --filter @composio/cli build`
- `pnpm --filter @composio/cli-local-tools build:composio-native-ui --
--target darwin-arm64`
- Manual launch via
`COMPOSIO_LOCAL_TOOLS_BIN_DIR=../cli-local-tools/local-tools-binaries
bun dist/bin.mjs dev native-ui --timeout 35`

## Notes / Risks
- This is a scaffold/prototype and is intentionally opened as a draft
PR.
- The visual effect uses a transparent AppKit panel,
`NSVisualEffectView`, and a Metal overlay. True optical distortion of
arbitrary content behind the window would require a different approach
such as ScreenCaptureKit/backdrop sampling and associated permissions.
- Generated sidecar executables remain ignored; release jobs rebuild
them before packaging artifacts.

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 01:30:14 -07:00
..

Local tool binary assets

Platform-specific executable and dynamic-library assets for first-party local tool integrations and CLI native sidecars are generated into this directory during local-tool binary builds.

Do not commit generated executables. Keep notices/licenses in git, pin source with git submodules under ts/packages/cli-local-tools/vendor/, and regenerate binaries in CLI release jobs before packaging artifacts.

Current native binary sources:

  • Beeper iMessage: vendor/platform-imessage (https://github.com/ComposioHQ/platform-imessage)
  • Peekaboo: vendor/peekaboo (https://github.com/steipete/Peekaboo)
  • Composio native UI sidecar: native/composio-native-ui (in-repository Swift package)

Build macOS sidecars for the current host/target with:

pnpm --filter @composio/cli-local-tools build:local-tool-binaries -- --target darwin-arm64
pnpm --filter @composio/cli-local-tools build:local-tool-binaries -- --target darwin-x64

Linux CLI artifacts skip these native sidecars. Chrome DevTools is an npm/npx-based integration and does not use this directory.