This extension brings Documatic to VSCode: quickly search your large codebases using simple queries - what does it do? what dependencies does it have? And more.
Documatic search uses AI to link relations between your query and snippets of code, so you don't have to know the exact keywords you're looking for!
- Codesearch
- Search your codebases using natural questions
See requirements for using the extension and a guide on how to use the extension below. Want more features? Open a feature request! See below for more information.
IMPORTANT: To use this extension,
you must have an active Documatic account.
Sign up for an account here.
If you're on the waitlist
and would like to get your team onboarded,
please contact [email protected]
to arrange a call.
On your Documatic account,
you must have indexed projects.
If you've very recently indexed a new codebase,
it takes a couple of minutes
for the codebase to become searchable;
if you're not getting results,
wait a few minutes.
If this persists,
please contact [email protected]
for help.
N.b. You currently cannot create
Documatic projects via the VSCode extension.
On the Documatic tab in VSCode, click "sign in". This will take you to the Documatic web platform, where you can sign in. Once you've signed in, you will see your Documatic organisations and projects.
N.b. You currently cannot manage organisations and projects from the extension. Please log in to the Documatic web application to make changes.
To run a search:
- Run the command "Documatic Search" or use the shortcut
cmd + K
. - Type in your search in query into the text field and press enter
- Select which project to run your search over (defaults to all projects)
- The extension shows which projects, if any, are in your active VSCode workspace
- The extension will display the top code snippets in a list
- Click on "view" to be navigated to a code snippet
- If the project is in your active VSCode workspace, your will be navigated to the code file
- If the project is not in your workspace, a copy of the code file will be created and opened
N.b. The version of the codebase indexed for search
is the main/master branch at time of indexing.
Documatic does not index a live version of your codebase.
The extension still works on other branches,
however changing branches or making updates to the code
may result in discrepencies between line numbers
when navigating to the code.
Documatic reindexes your codebases regularly.
If you would like non-main branches to be indexed
for your team,
please contact [email protected]
.
If you logged into Documatic on the VSCode app
and subsequently added more projects/organisations,
you will need to fresh your connection.
You can do this by pressing the reload/refresh
icon
at the top of the Documatic panel,
or alternatively by running the command:
ctrl+shift+p
to bring up the command panel- Enter the
Documatic: Refresh
command
If you need to sign out of your Documatic account
on VSCode,
press the exit
icon
at the top of the Documatic panel,
or alternatively by running the command:
ctrl+shift+p
to bring up the command panel- Enter the
Documatic: Clear
command
- Your signed in session can time out on the extension without the UI updating
- As a temporary work around, clearing your VSCode session can reset this
- On some VSCode versions, an error occurs when running a search
- Please update your VSCode and restart your system
If you have found a bug you would like to report or if there is a feature you would added, please open an issue on the public issue tracker.
If you believe you have found a security vulnerability,
please do not post details on public channels.
Instead,
please contact [email protected]
or [email protected]
with details of the vulnerability.
For more information,
please see SECURITY.md.
Contributions are welcome! If you have a bug to report or a feature to request, please feel free to open an issue. If you would like to open a pull request, please refer to the contributing guide
For full release notes, please see the complete changelog in the repository.
Fixed a sign-in issue.
Initial release of Documatic's VSCode extension. Comes with codesearch and code snippet analysis.
Apache 2.0. Read [the license] for full terms.
Documatic is a startup
building tools to help you better understand your code.
Don't ask your boss,
ask Documatic.