# Oxygen for Visual Studio Code

Source control integration for Oxygen (`oxy`) repositories: a
Source Control view with changes and conflicts, diffs against the working
copy's base, quick-diff gutters, explorer decorations, a status bar item, and
commit from the input box. The full design, milestone by milestone, is in
`docs/spec.md` in this repository.

## Requirements

- Visual Studio Code 1.137 or later.
- `oxy` 0.1 or later on your PATH, at `~/.local/bin/oxy`, or named in the
  `oxygen.path` setting. The extension drives `oxy --json` and never reads
  `.oxy/` itself.

## Building

```
npm install
npm run check          # typecheck, bundle, and test against the oxy binary
npm run package        # oxygen-vscode-<version>.vsix
code --install-extension oxygen-vscode-0.1.0.vsix
```

`npm run watch` rebuilds on change; press F5 in VS Code to launch an
Extension Development Host with the bundle.

## Status

Milestone 0.1 (read-only plus commit) of the spec. Bookmarks, sync, history,
blame, conflicts, subrepos, bisect and trust views follow in 0.2 to 0.6.

## Licence

MIT or Apache-2.0, at your option, as for Oxygen itself.