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.
-
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
andpikchr
files -
Syntax highlighting for
pikchr
language -
Use command palette
Ctrl-Shift-P
>>fossil:
to see all commands. (Not everything has a UI control.)
- Click a file see the diff view
- Or open a file by using context menu
- Just click the Fossil icon from the source control title area
- Follow prompts
- 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.
-
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
- Run
Stash Snapshot
command - Manually remove lines that you don't want in the commit
- Make a commit
- Run
Stash Pop
- Run
-
Blame
Use
Fossil: praise
command from command palette
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 }
- 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
on the PATH. - Takes effect immediately.
fossil.username { string }
- Specifies an explicit user to use for fossil commits.
- This should only be used if the user is different than the fossil default user.
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. |
- Please report any bugs, suggestions or documentation requests via the Github issues (yes, I see the irony).
- Feel free to submit pull requests.
Ben Crowl, koog1000, senyai, ajansveld, hoffmael, nioh-wiki, joaomoreno, nsgundy