Skip to content

Your always-on AI coworkers that move between text, calls, and Slack.

TypeScript

docs: say how to get the Intelligence project key

Benjamin Taylorfad7c1764223
diff --git a/README.md b/README.md
index 49dfde4..9031cce 100644
--- a/README.md
+++ b/README.md
@@ -160,7 +160,18 @@ cp .env.example .env
npm run dev
```
-Open **http://127.0.0.1:5173**. You can create Spaces, write pages, and configure Dots before connecting services. Add your conversation and model settings to `.env` to start chatting.
+Open **http://127.0.0.1:5173**. You can create Spaces, write pages, and configure Dots before connecting services. To start chatting, connect an Intelligence project and a model.
+
+Sign in to CopilotKit and select or create the Intelligence project. Run these commands in the `OpenDots` folder:
+
+```sh
+npx copilotkit@latest login
+npx copilotkit@latest project select
+```
+
+`project select` writes a project key to `.env` as `CPK_INTELLIGENCE_API_KEY`. Then add `OPENAI_API_KEY` and `OPENAI_MODEL` to `.env` and restart `npm run dev`.
+
+Do not run `copilotkit onboard` in this folder. OpenDots already contains its CopilotKit integration, and onboarding adds a second, generic one.
See [Setup](docs/SETUP.md) for configuration, Slack, calls, the browser service, and Docker.
diff --git a/docs/SETUP.md b/docs/SETUP.md
index 077c0ac..7362360 100644
--- a/docs/SETUP.md
+++ b/docs/SETUP.md
@@ -25,6 +25,17 @@ Open http://127.0.0.1:4310. Keep the server running for background work.
## Conversation services
+OpenDots stores conversations in a CopilotKit Intelligence project. To get the project key, run these commands in the OpenDots folder after `cp .env.example .env`:
+
+```sh
+npx copilotkit@latest login
+npx copilotkit@latest project select
+```
+
+`login` opens the browser to sign in or create an account. `project select` lets you select or create a project, and writes a project-scoped key to `.env` as `CPK_INTELLIGENCE_API_KEY`. It removes an `INTELLIGENCE_API_KEY` line, so that the file holds one credential. Use the same project for Slack and Automatic Learning below.
+
+Do not run `copilotkit onboard` in this folder. Onboarding is for apps that do not have CopilotKit yet. OpenDots already has its integration.
+
Edit `.env` on the server and restart after changes:
| Variable | Purpose |