CLI Reference

Gillya CLI gives you direct access to all marketing tools from your terminal.

Installation

Clone the repository and install dependencies to get started with the CLI.

# Глобальне встановлення
npm install -g gillya-cli

# CLI готовий
gillya --help
gillya chat "як налаштувати CRM?"

💡

You need Node.js 18+ and npm installed. The CLI works on Windows, macOS, and Linux.

Commands

All available CLI commands organized by skill.

Авторизація

# Увійти в акаунт (через браузер)
gillya login

# Зареєструвати новий акаунт
gillya register

# Показати поточного користувача
gillya whoami

# Вийти з акаунта
gillya logout

Налаштування проєкту

# Get Started візард
gillya init

# Статус проєкту та AI налаштувань
gillya status

# Налаштування провайдера/ключа/моделі
gillya config                      # показати конфіг
gillya config set provider         # інтерактивний вибір провайдера
gillya config set api_key sk-...   # встановити API ключ
gillya config set model gpt-4o     # встановити модель
gillya config sync                 # синхронізувати з акаунтом

AI Агент

# Одноразова задача
gillya agent "зроби стратегію для стоматології з бюджетом 2000 грн/день"

# Інтерактивний чат
gillya chat

# Оновити CLI до останньої версії
gillya update

Підключення до AI агентів

Після `gillya connect` ваші AI агенти отримають доступ до інструментів Gillya:

# Інтерактивний вибір агентів
gillya connect

# Підключити всіх агентів
gillya connect --agents all

# Підключити конкретних
gillya connect --agents claude-code,pi,cursor

Підтримувані агенти та їхні команди:

Агент	Файл конфігу	Команди
Claude Code	.claude/mcp.json	MCP (cluster_keywords, crm_*)
Cursor	.cursor/mcp.json	MCP (cluster_keywords, crm_*)
Cline	.cline/mcp.json	MCP (cluster_keywords, crm_*)
Windsurf	.windsurf/mcp.json	MCP (cluster_keywords, crm_*)
Continue	.continue/config.json	MCP (cluster_keywords, crm_*)
VS Code Copilot	.vscode/settings.json	MCP (cluster_keywords, crm_*)
Claude Desktop	глобальний конфіг	MCP (cluster_keywords, crm_*)
OpenCode	opencode.json	MCP (cluster_keywords, crm_*)
pi.dev	.pi/extensions/gillya.ts	/gillya-chat, /gillya-status, /gillya-config, /gillya-set-provider

Перший запуск

При запуску gillya без аргументів CLI автоматично:

Показує список команд
Якщо не знайдено AI агентів — пропонує запустити gillya connect
Після підключення — просто показує help

PPC Commands

Cluster keywords and calculate tROAS from the command line.

# Keyword clustering
gillya ppc cluster --keywords "купити кросівки,ремонт взуття київ,ціна на кросівки"

# From CSV
gillya ppc cluster --file keywords.csv

# tROAS calculation
gillya ppc troas --budget 2000 --cpc 15 --conversion-rate 3 --avg-order-value 800

Option	Type	Description
--keywords, -k	string	Comma-separated keywords
--file, -f	path	Path to CSV file from Google Keyword Planner
--budget, -b	number	Daily budget in UAH
--cpa, -c	number	Target CPA in UAH

MCP Server

Expose all Gillya tools via Model Context Protocol for use with any MCP client.

Quick Start Guide

# Start MCP server
gillya mcp

Claude Desktop / VS Code

Add to your MCP client configuration:

{
  "mcpServers": {
    "gillya": {
      "command": "gillya",
      "args": ["mcp"]
    }
  }
}

Available MCP Tools

Tool	Description
/gillya-chat	AI chat (pi.dev)
/gillya-status	Project status (pi.dev)
/gillya-config	Show AI settings (pi.dev)
/gillya-set-provider	Configure AI provider interactively (pi.dev)
cluster_keywords	Cluster Google Ads keywords by intent
crm_connect	Connect a CRM (HubSpot, Pipedrive, Airtable)
crm_status	Check CRM connection status
crm_sync_lead	Sync a lead to active CRM
analyze_troas	Calculate tROAS for Google Ads