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