# uigrep

uigrep is a local-first visual context bridge for coding agents. Start the background app, press a shortcut, annotate one or more UI regions in the browser, and let an MCP-enabled coding harness retrieve only the context it needs.

## Product principles

- The desktop UI is a fixed, non-expandable status pill.
- Capture happens in the user's real browser.
- The harness current working directory is the codebase root.
- Context is stored locally and disclosed progressively.
- No cloud account, telemetry, or hidden model calls.

## Workspace

- `apps/desktop` — Tauri desktop shell, local daemon, and status pill.
- `apps/extension` — WXT browser companion for Chromium and Firefox.
- `apps/test-app` — deterministic UI used by integration tests.
- `packages/schema` — canonical capture contracts and budgets.
- `packages/bridge` — authenticated loopback protocol helpers.
- `packages/mcp` — generic MCP stdio adapter.

## Prerequisites

- Node.js 22+
- pnpm 10+
- Rust stable and the platform prerequisites for Tauri 2

## Development

1. Run `pnpm install`.
2. Run `pnpm check`.
3. Run `pnpm --filter @uigrep/desktop tauri dev` for the desktop app.
4. Run `pnpm --filter @uigrep/extension dev` for Chromium or `pnpm --filter @uigrep/extension dev:firefox` for Firefox.
5. Run `pnpm --filter @uigrep/test-app dev` for the fixture page.

The initial default shortcut is `Alt+Shift+G` (`Option+Shift+G` on macOS), and it will be configurable.