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

## What it does

- **Source Control view**: Changes, Conflicts and Subrepos groups; open

  changes as a diff against the working copy's base; discard, commit

  selected paths, commit chosen hunks, amend; `Ctrl+Enter` commits.

- **Editor**: quick-diff gutters, explorer and tab decorations, inline blame

  (toggle from the context menu), file history with diffs between versions,

  CodeLens actions over conflict markers (accept a side, all sides, or a

  deletion), keep-this-candidate for tree conflicts, Mark Resolved.

- **Status bar**: bookmark, working copy and state; click to switch, create,

  merge or delete bookmarks; a sync counter with Sync, Fetch, Pull, Push and

  Push Bookmark.

- **Commit box**: amend mode, previous messages, a note of whether the next

  commit is signed, sealed at push or unsigned, and a warning before

  committing leftover conflict markers.

- **Links**: Open on Remote, Copy Remote Link and Copy Permalink from the

  line-number gutter and the editor context menu, for a line or the

  selection; permalinks pin the bookmark's current state.

- **Views**: Oxygen Operations (undo to any point), Oxygen Bisect

  (start, good, bad, skip, run, reset), Oxygen Trust (policy, signatures),

  and a History graph with per-change actions (diff, check out, describe,

  tag, abandon, and split, squash and rebase from the picker or by

  right-clicking a row, each confirmed and undoable).

- **Commands**: Show History, File History, Tags, Create Tag, Add Workspace,

  Update Subrepos, Verify Signatures, Clone Repository, Initialize Repository,

  Show Output.

## Status

Milestones 0.1 to 0.6 of the spec are implemented (see CHANGELOG.md). Left

for 1.0: tests on macOS and Windows, a Marketplace publisher, and the open

questions in the spec.

## Licence

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