# OxygenHub for Visual Studio Code

Proposals, reviews, issues and checks from an OxygenHub in

the editor, built on the Oxygen extension the way the

GitHub Pull Requests extension builds on the built-in Git extension. The

specification is docs/spec.md in the repository.

- **Sign in** with a hub URL and a personal access token (Settings › Tokens on the hub).

- **Proposals** view: needing me, mine, open; detail with blockers, approvals, checks and changes; check out the projected state; review; seal your approval and land, both through `oxy` in a terminal with your own key.

- **Issues from the editor**: turn a selection or a TODO line into an issue that quotes the code and links to it.

- **References while typing**: `#` and `@` completion in the commit box and comments, and a hover on `#N`.

- **Notifications**: an unread count in the status bar and an inbox that opens proposals and issues in the editor.

- **Diffs in the editor**: expand a proposal to its files and open each in VS Code's diff editor (target against projected state), or View Changes for all of them at once, without checking out.

- **Review threads** in those diffs and on the checked-out proposal's files, anchored to atoms so they follow lines through rebases.

- **Issues** view: open, create, comment, close, assign.

- **Releases** view: releases with their assets; draft a release from a tag with notes written from the changes since the last one.

- **Open on Remote** in the Oxygen extension works for hubs once this extension is installed.

- **Status bar**: the checks of the proposal whose source is your current bookmark, live.

`npm run check` type-checks, bundles and runs the Node tests; the hub client tests start a real hub from `../oxygenhub/target/release/oxygenhub` when it exists.