# Oxygenhub for Visual Studio Code

Proposals, reviews, issues and checks from an [Oxygenhub](../oxygenhub) in

the editor, built on the [Oxygen extension](../oxygen-vscode) the way the

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

specification is [docs/spec.md](docs/spec.md).

- **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.

- **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.