Skip to content
This repository has been archived by the owner on Oct 11, 2024. It is now read-only.
/ companion-vscode Public archive

VSCode extension of Quack Companion πŸ’» Turn your team insights into a portable plug-and-play context for code generation. Alternative to GitHub Copilot powered by OSS LLMs (Mistral, Gemma, etc.), served with Ollama.

License

Notifications You must be signed in to change notification settings

quack-ai/companion-vscode

Quack Companion - IDE extension

API ・ VSCode extension ・ Documentation

CI Status eslint prettier codacy

VS Marketplace Open VSX Registry Node.js license

Twitter

Smart linting and code chat overcharged by your team insights in VSCode

quack_companion_vscode_chat.mp4

Quick Tour

Code chat

Code chat

Coding guideline curation

Guideline view

Once installed, when you open a project, the extension will give you a new tab where you'll find:

  • Guideline curation: curate your software insights with your team
  • Code chat: ChatGPT but for developers
  • Smart linting (temporarily disabled)
  • Code completion (coming soon)

Walthrough tutorial

Developer walkthrough

With our walkthrough tutorial, you're only a few clicks away from having your own coding companion.

Setup

Prerequisites

Install VSCode

Install the extension

Either:

  • Follow the instructions on the online VS Marketplace page
  • In VSCode, click on Extensions in the sidebar, search for "Quack Companion" and click on "Install"

Roadmap

The ultimate goal for this extension is to offer a smooth contribution experience for any developer. The development efforts will be focused on achieving the following milestones:

  • 🀝 Turn contribution guidelines into a live pair coding experience (code completion & code chat)
  • 🐣 Help any developer find a starter contribution opportunity
  • βš–οΈ Ensure alignment between the contribution goal and the project's priorities

Telemetry

Why we collect information

Quack is dedicated to transform the contribution workflow of developers. Developer tools are among the most difficult types of product to build and we need to better understand where to allocate/reduce our efforts over time.

Since we want to keep providing free options for our services in the future, and since we don't want to rely on advertising, we humbly ask you to share limited usage data so that we can improve the products and services that we offer.

What we collect

For each event, here is the largest amount of data we collect:

  • Event identifiers: the event type (e.g.fetch-guidelines) and potentially the scope (e.g. the repository)
  • User information: depending on the telemetry setting, either your GitHub username or an anonymized UUID specific to you (created when you first activate the extension).

And since the extension is open source, you can navigate the codebase to verify the above information if you feel like it ;)

What you can do about it

This data collection is done using Posthog and can be:

  • 😟 anonymized: by default we'll identify your actions with your GitHub username. We'll keep an option to prevent that identification, as we understand it's important for developers to have this choice.
  • 😭 disabled: like in most VSCode extensions, you have the ability to disable telemetry completely.

Copying & distribution

Copyright (C) 2023-2024, Quack AI.

This program is licensed under the Apache License 2.0. See LICENSE or go to https://www.apache.org/licenses/LICENSE-2.0 for full license details.

Contributing

Feeling like improving the interface? Or perhaps submitting a new feature idea? Any sort of contribution is greatly appreciated!

You can find a short guide in CONTRIBUTING to help grow this project! And if you're interested, you can join us on