# Wizard Browser Extension

*A Chrome extension that runs Holdex's engineering process on top of GitHub*

**Authors:** [Vadim Zolotokrylin](https://holdex.io/c/people/vadim-zolotokrylin)

---

Holdex's engineering process is documented and enforced.
Goal issues need spec links, ETAs, and the right labels.
PR time gets logged.
Bugs get attributed to commits.
Cross-org project tracking happens in one place.
None of that comes for free in vanilla GitHub.
Wizard is the Chrome extension that makes the workflow feel native.

## What it does

Wizard layers on top of github.com and adds the same workflow
that the Holdex Automation GitHub App
([`apps/holdex`](https://github.com/apps/holdex)) enforces from the server side.

- **Goal issue validation.**
  The `Goal:` title prefix, the `type: goal` label, issue type settings,
  spec-doc links, and ETA presence are checked inline.
  Overdue ETAs surface warnings,
  and a missing spec document can be created on the spot.
- **Cross-organisation project tracking.**
  One-click issue addition into the right project across multiple GitHub orgs.
  Up to three projects can be managed directly from the extension popup,
  with project links updating automatically as projects are added or removed.
- **Calendar integration.**
  Create a Google Calendar event from a GitHub issue with auto-populated
  details, respecting the local timezone.
- **Subscription management.**
  Customise issue and PR notification subscriptions with visual status
  indicators.
  Subscribe or unsubscribe from all events at once,
  or target specific event types such as Closed, Reopened, or Merged.
- **Side panel.**
  A persistent panel on the right of the browser surfaces related Attio Deals,
  assigned tasks, and due dates alongside the GitHub UI without leaving the
  page.

The extension is published by Holdex Limited on the Chrome Web Store with scoped
permissions: `activeTab` to interact with the current GitHub issue page,
`storage` to save preferences and project data locally, `tabs` to open
spec-document creation, and `sidePanel` for the persistent panel.
Wizard ships against the workflow it serves, often.

## Holdex's role

End-to-end.
Wizard is a Holdex internal tool that became publicly listed
once the workflow it enforces had stabilised.
The companion server-side piece is the Holdex Automation GitHub App,
documented at [wizard.holdex.io](https://wizard.holdex.io/),
which provides a slash-command interface for the same process from inside issue
and PR comments.

## Links

- Command reference: [wizard.holdex.io](https://wizard.holdex.io/)
- Companion GitHub App: [github.com/apps/holdex](https://github.com/apps/holdex)
- Chrome Web Store:
  [Wizard Browser Extension](https://chromewebstore.google.com/detail/wizard-browser-extension/gibcadmedmabfnfbolimcndljcopbhep)
  by Holdex Limited

Contributions are welcome and must align with the Holdex Developer Guidelines.