In this Quickstart Guide, you’ll use Factory to Q&A your codebase, create a feature, and save it down to your local files.

Make sure you have access to Factory before getting started.

Step 1: Open Factory and Create a Session

1

Launch Factory

Open the Factory application in your browser.

2

Select Your Droid

Select the appropriate Droid based on your project needs.

Note, that each Droid is provisioned highly specific system prompts and tools that make them particularly adept at certain tasks.

3

Choose your Model and Tools

Select your desired Model and activate the necessary Tools for your task.

Tools extend the functionality of the Factory Droids beyond the Factory platform. The Github tool, for example, creates a bi-directional integration with Github/Gitlab while our Project Management tool does the same with Jira/Linear.

See our Integrations guide to connect your Github/Gitlab and Jira/Linear.

Step 2: Connect to Your Local Machine

1

Add a Local Repo

Click on Select Repo and select + Add Local Repo

2

Connect to Local Machine

Factory Bridge creates a secure connection between the Factory platform and your local machine, enabling powerful capabilities like running CLI commands, managing local processes, and accessing local resources directly from your Factory sessions.

See our Integrations guide to connect your Github/Gitlab.

3

Download Factory Bridge

Download the Factory Bridge and move the Bridge to the Applications folder. Then, set your Root Directory.

4

Connect to the Factory Bridge

Enter the pairing code in the Bridge app to connect.

5

Add your Local Repo

Return to the Factory platform and select a Local Repo to add to your session.

Local repositories may take a few minutes to index.

Step 3: Codebase Q&A

1

Ask Factory Any Question

Ask anything about your Codebase and referencing any relevant repositories or context using the ”@”. You can tag any remote/local repository, file, pull request, ticket, notion doc, or Google Doc for consideration.

Learn more about Context Retrieval

2

Clarification and Response

View Factory’s Response. The Factory Droid may return with clarification questions to ensure it understand exactly how you would like the Droid to execute on the task.

Step 4: Execution

1

Request Factory to Generate Code

Factory will generate the code for the requested feature. Factory will launch a new session with the prompt and included context.

2

View and Save Files

Leverage Factory’s Auto-Save feature to immediately save all files down to the appropriate location in your local directories. You can also enable Auto-Accept for CLI commands and Tool Use to provide a truly autonomous experience.

Congratulations! 🎉

You’ve just built a UI component using Factory. This is just the beginning of what you can do with Factory.

Next Steps