CLI Setup

Install the Conversa CLI globally so you can run conversa from any project directory without re-initialising.

What the CLI installs

The installer writes a single config file to ~/.conversa/config.json. This is the same location used by the conversa shell command, the VS Code extension, and the GitHub Action. Once installed, all three tools share the same config automatically.

Step 1 — Install the CLI files

Run the one-line installer to create the Conversa CLI directory:

node -e "const fs=require('fs'),os=require('os'),path=require('path');const d=path.join(os.homedir(),'.conversa');fs.mkdirSync(path.join(d,'bin'),{recursive:true});fs.writeFileSync(path.join(d,'config.json'),JSON.stringify({version:'2.0.0',endpoint:'https://chatbot-lac-eight-78.vercel.app/api',installed:new Date().toISOString()},null,2));console.log('Conversa CLI installed at',d);"copy

Step 2 — Add to PATH

Add the Conversa CLI to your shell so you can run conversa from any directory. Paste these two lines into your terminal:

echo '' >> ~/.zshrc && echo '# Conversa CLI' >> ~/.zshrc && echo 'export CONVERSA_HOME="$HOME/.conversa"' >> ~/.zshrc && echo 'export PATH="$CONVERSA_HOME/bin:$PATH"' >> ~/.zshrccopy

Step 3 — Reload and verify

source ~/.zshrc && echo $CONVERSA_HOMEcopy