Gentlybot docs

Connect your team’s app.

Let Gently get the project running with minimal supervision. Teammates can then start isolated development environments in their threads without doing their own setup.

01

Sign in with GitHub or Google and open your workspace. Install the Gentlybot GitHub App for the repositories you want to use. If you signed in with Google, connect GitHub from your workspace. Your GitHub organization may require an administrator to approve the installation.

Integration setup
02

Create a project and select its primary repository. Add context repositories when the product also depends on a separate API, worker, documentation site, or shared library. Threads use the project to stay grounded in the right code.

03

Ask Gently to inspect the repositories, configure the toolchain and services, install dependencies, and get the app running. Gently saves the environment configuration and checks that a fresh environment can start from it. Provide development credentials or project details when needed; teammates do not have to repeat this setup. Templates include a starting configuration already.

Open the apps.yml reference

Set up this project for the team. Inspect all connected repositories, configure the required tools and services, and get the app running. Diagnose and fix setup failures, then verify that a fresh environment works from the saved configuration. Ask me for access or project details you cannot infer.

04

Start a thread in the project and open its preview when the environment is ready. Check a representative page and any services it needs. A working homepage is a useful start; a flow that reaches the API and database gives the team a better foundation.

Run this app, open its main page, and check that the API and database are reachable. Report what worked and anything I need to configure.

05

Invite teammates to the workspace and review model, permission, and review settings. Each new thread gets an isolated environment from the project setup. PMs, designers, QA, and engineers can open the app and work on separate ideas without installing it locally. Invite people into the same thread when they need to collaborate on one task.

Workspace controls
  • Ask Gently to inspect the setup and startup logs, diagnose the failure, and fix the environment configuration.
  • Let Gently check package versions, ports, health checks, and backing services, then rerun setup.
  • Provide missing development credentials or access when Gently asks.
  • Ask it to verify the fix in a fresh environment so future threads can use the saved setup.

A setup problem in one thread does not stop other threads from working. You are ready to invite others when the preview opens and a representative flow works. Teammates can then follow Your first thread.