abhifuse / sf-explorer

Find the right sf commands without digging through the cli documentation using openai

sf-explorer - Simplify Your Search for sf Commands

Introduction

sf-explorer is a tool that helps you find the right sf commands without having to dig through the documentation. Under the hood, sf-explorer uses a vector store (ChromaDB) to store and index the Salesforce CLI documentation. This indexed data is then used to provide accurate and relevant command suggestions based on your queries.

The tool leverages OpenAI embeddings to understand the context and semantics of your queries. It uses the ConversationalRetrievalQAChain from Langchain to generate responses, ensuring that the answers you get are not only accurate but also contextually relevant to your query.

Demo : https://explorer.sfdxy.com/

Prerequisites

Before getting started with sf-explorer, make sure you have the following prerequisites in place:

• Node.js installed
• Yarn package manager installed
• Chroma installed and running

.env Setup

To use sf-explorer, you need to set up your environment variables. Follow the steps below:

1. Obtain an OpenAI API key.
2. Open the .env file in your project directory.
3. Set the value of OPENAI_API_KEY to your OpenAI API key.

Setup

To set up sf-explorer for your project, follow the steps below:

1. Install the necessary packages by running yarn install in your project directory.
2. Run yarn refresh-chroma to ensure Chroma is up to date.
3. Run yarn dev to start sf-explorer locally.
4. Open http://localhost:7456/ to access the app.

Publishing

To publish your sf-explorer app, follow these steps:

1. Run yarn build.
2. Publish the generated build files to your desired hosting platform.

Inspired By

sf-explorer was inspired by gitexplorer, a similar tool for finding the right Git commands.