Integrated Fossil source control for Visual Studio Code

Prerequisites

This extension leverages your machine's Fossil installation, so you need to install Fossil first. Also read the cloning documentation for info about cloning from the extension.

Features

• Add files and commit from the source control panel (i.e. where git normally appears).

• All the basics: commit, add, revert, update, push and pull.

• See changes inline within text editor.

• Interactive log for basic file history and diff.

• Branch, merge, resolve files.

• Praise

• Quickly switch branches, push and pull via status bar.

• Supports named-branches workflows.

• Automatic incoming/outgoing counters.

• Undo/Redo.

• Preview md, wiki and pikchr files

• Syntax highlighting for pikchr language

• Use command palette Ctrl-Shift-P >> fossil: to see all commands. (Not everything has a UI control.)

View file changes

• Click a file see the diff view
• Or open a file by using context menu

Initialize a new repo

• Just click the Fossil icon from the source control title area
  • Follow prompts

Update to a branch/tag

• The current branch name is shown in the bottom-left corner.
• Click it to see a list of branches and tags that you can update to.

How to

• Checkout by hash?

  Use branch menu in the status bar.

• Create a new branch?

  Create a branch with "Commit Creating New Branch..." action in SCM menu or in command palette.

• Modify commit message?

  Use "Fossil log" from command palette and navigate the options till specific checkout.

• Get current checkout hash or tags?

  Hover over current branch name in the status bar

• Close/reopen a branch?

  Use 'Close branch...' and 'Reopen branch...' actions from command palette.

• Commit partially

  1. Run Stash Snapshot command
  2. Manually remove lines that you don't want in the commit
  3. Make a commit
  4. Run Stash Pop

• Blame

  Use Fossil: praise command from command palette

Settings

fossil.enabled { boolean }

• Enables Fossil as a source control manager in VS Code.

fossil.autoRefresh { boolean }

• Enables automatic refreshing of Source Control tab and badge counter when files within the project change: "true" — enabled "false" — disabled, manual refresh still available.

fossil.path { string / null }

• Specifies an explicit fossil file path to use.
• This should only be used if fossil cannot be found automatically.
• The default behaviour is to search for fossil in commonly-known install locations and on the PATH.

fossil.username { string / null }

• Specifies an explicit user to use for fossil commits.
• This should only be used if the user is different than the fossil default user.

Troubleshooting

In general, Fossil designers maintain an abundance of documentation. Reference that documentation as much as possible.

Issue	Resolution
Unknown certificate authority	Read the Fossil SSL Documentation to update fossil with the correct CA
inputBox prompt difficult to read	Run the same fossil command on the built-in terminal (Ctrl+`). Unfortunately VS Code strips newlines and tabs from inputBox prompts.

Feedback & Contributing

• Please report any bugs, suggestions or documentation requests via the Github issues (yes, I see the irony).
• Feel free to submit pull requests.

For developers

• Building and debugging
• Api behavior
• Releasing

Acknowledgements

Ben Crowl, koog1000, senyai, ajansveld, hoffmael, nioh-wiki, joaomoreno, nsgundy