You Secure
Multi-Agent & Developer Documentation

You Secure PaaS CLI & Docs

Suba qualquer aplicação na infraestrutura You Secure em São Paulo com latência inferior a 15ms, provisione bancos de dados dedicados estritamente na sua conta e aponte domínios automaticamente com SSL.

Instalação em 1 Comando (Linux / macOS)

Instale o CLI You Secure no seu terminal ou ambiente de CI/CD

Compatível com Mac, Linux, WSL e qualquer ambiente de desenvolvimento. Zero dependências externas (Python nativo).

Terminal Bash / Zsh
curl -fsSL https://yousecure.io/install.sh | bash

1. Instalação do CLI

O CLI yousecure é um binário autônomo escrito em Python nativo. Ele não requer nenhum pacote externo ou compilação e roda instantaneamente em qualquer máquina.

Instalação Automática via Terminal:

cURL Installer
curl -fsSL https://yousecure.io/install.sh | bash

Instalação Manual (Download Direto):

Manual /usr/local/bin
sudo curl -fsSL https://yousecure.io/cli -o /usr/local/bin/yousecure && sudo chmod +x /usr/local/bin/yousecure

Verifique a instalação digitando: yousecure --help

2. Autenticação & API Keys

O CLI e as IAs se conectam à sua conta por meio de uma chave de API persistente com formato yspaas-<token>.

Opção A (Recomendada): Autenticação Automática via Navegador

Abre o navegador, autoriza a sua conta e conecta o terminal automaticamente (sem copiar chaves):

1 Comando (Navegador Automático)
yousecure auth

Opção B: Login com Email e Senha no Terminal

Login Direto
yousecure login --email [email protected] --password sua-senha

Opção B: Login com Chave de API direta

API Key Token
yousecure login --key yspaas-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Opção C: Usando Variável de Ambiente (Ideal para CI/CD e IAs)

Environment Variable
export YOUSECURE_API_KEY="yspaas-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Para confirmar sua autenticação, execute: yousecure whoami

3. Skill Autônoma para IAs

Cursor • Claude Code • Windsurf • GitHub Copilot • Antigravity • Roo Code • ChatGPT

Com a Skill You Secure PaaS, qualquer assistente inteligente passa a operar como um Engenheiro Cloud & DevOps Sênior no seu projeto. A IA inspeciona seu repositório Git, identifica a stack, detecta dependência de banco de dados, provisiona a instância dedicada do banco, injeta variáveis de ambiente, executa o deploy na Nuvem You Secure em São Paulo e configura o apontamento DNS.

Instalação da Skill em 1 Comando (Terminal) Configura Cursor, Claude, Windsurf e Copilot
Terminal Bash / Zsh
curl -fsSL https://yousecure.io/paas/install-skill.sh | bash

Se já tiver o CLI instalado, basta rodar: yousecure skill na pasta do seu projeto.

Texto Escrito da Skill para Copiar e Colar

Use em qualquer IA (ChatGPT, Claude Web, Perplexity, Copilot ou em arquivos de regras).

Clique para ocultar ou expandir o código da skill ▼
---
name: yousecure-paas
description: Autonomous deployment, dedicated database provisioning (PostgreSQL, MySQL, MongoDB, Redis), custom domain routing, SSL, and DNS management on You Secure PaaS (São Paulo datacenter, <15ms latency).
globs: ["*"]
alwaysApply: false
---

# You Secure PaaS — Autonomous AI Skill

You are an expert DevOps and Cloud Architect with full authority to deploy applications, provision dedicated database instances, configure custom domains with SSL certificates, and manage DNS on **You Secure PaaS** (datacenter in São Paulo, Brazil with sub-15ms latency).

## 1. When to Use This Skill
Activate this skill whenever the user:
- Asks to deploy, publish, or host their web project or backend.
- Asks to create, connect, or list databases (PostgreSQL, MySQL, MongoDB, Redis).
- Asks to configure or point a domain/subdomain (e.g., `app.meudominio.com.br`).
- Asks about environment variables (`DATABASE_URL`, `REDIS_URL`, etc.).
- Asks to check application deployment status or inspect logs.

## 2. Infrastructure Architecture & Multi-Tenant Model
- **Borda & Gateway:** Gateway de alta disponibilidade com proteção DDoS e certificados SSL automáticos Let's Encrypt.
- **Computação:** Plataforma de execução elástica em São Paulo (SP-01) com suporte a auto-scaling e instâncias aquecidas.
- **Bancos Dedicados:** Cluster de bancos dedicados com instâncias 100% isoladas por conta. CPU, RAM e armazenamento garantidos com isolamento de rede e credenciais restritas.
- **DNS Corporativo:** Nameservers corporativos (`ns1.yousecure.io` / `ns2.yousecure.io`) ou apontamento CNAME para `cname.yousecure.io` (ou A para `82.38.173.20`).
- **Armazenamento Agrupado (Pooled Storage):** O cliente pode provisionar múltiplos bancos de diferentes tecnologias (ex: PostgreSQL + Redis), compartilhando o pool total de disco do plano (5 GB no Básico, 25 GB no Performance, 100 GB no Ultra). Cada banco opera em instância isolada com limites dedicados de CPU e RAM.

---

## 🔄 Documentação Canônica & Atualizações da Skill
- A plataforma You Secure PaaS e o CLI evoluem frequentemente e esta skill pode sofrer mudanças contínuas de novos recursos, parâmetros e comandos.
- **SEMPRE QUE INICIAR UMA TAREFA OU ENCONTRAR UM ERRO INESPERADO:** Consulte a documentação oficial ao vivo em:
  👉 **`https://yousecure.io/paas/docs`**
- **Para atualizar esta skill no projeto para a versão mais recente em 1 comando:**
  ```bash
  yousecure skill
  # ou
  curl -fsSL https://yousecure.io/paas/skill.md -o .cursor/rules/yousecure-paas.mdc
  ```

---

## ⚠️ REGRA CRÍTICA DE EXECUÇÃO: TERMINAL CLI APENAS (NUNCA USAR CHROME / NAVEGADOR)
- **NUNCA USE NAVEGADOR OU CHROME:** Não tente abrir o navegador, automatizar cliques (Puppeteer/Playwright) nem navegar pelo painel web do You Secure PaaS para fazer deploy ou criar bancos. O deploy DEVE ser executado 100% no terminal headless.
- **UTILIZE O CLI OU REST API:** Execute exclusivamente via comando de terminal `yousecure` ou requisições HTTP `curl`.
- **SE O SEU AMBIENTE NÃO TEM TERMINAL (ex: ChatGPT Web sem ferramenta de bash/shell):**
  - **NÃO** tente abrir o site ou usar ferramentas de navegação web (Browsing / Chrome).
  - **EM VEZ DISSO:** Entregue os comandos CLI exatos (`yousecure auth`, `yousecure deploy ...`) formatados em blocos de código markdown para que o usuário copie e execute no terminal dele.

---

## 3. Autonomous Execution Workflow

### Step 1: Pre-flight Verification & Auth
Run:
```bash
yousecure whoami
```
- If unauthorized or no API key is found:
  - Instruct the user to run: `yousecure auth` (opens browser, logs in, and saves credentials automatically)
  - Or configure API key manually: `yousecure login --key yspaas-...` or `export YOUSECURE_API_KEY="yspaas-..."`
- Inspect the output to verify:
  - Active Plan (e.g., Starter, Performance, Ultra).
  - Databases used vs allowed quota (e.g. `2 / 5 bancos`).
  - Disk storage used vs pooled limit (e.g. `340 MB / 25 GB`).

### Step 2: Stack & Database Detection
Inspect the local codebase:
- **Repository & Branch:** Determine git remote url (`git remote get-url origin`) and current branch (`git branch --show-current`).
- **Framework:**
  - Next.js / React / Vue / Vite / Nuxt / Node.js
  - Python (FastAPI / Flask / Django)
  - PHP / Laravel / WordPress
  - Go / Rust / Dockerfile
- **Database Requirement:**
  - Check `.env.example`, `prisma/schema.prisma`, `drizzle.config.ts`, `ormconfig.json`, `database.php`, `settings.py`, or `package.json`.
  - If PostgreSQL is used -> set `--db postgresql`.
  - If MySQL / MariaDB is used -> set `--db mysql`.
  - If MongoDB is used -> set `--db mongodb`.
  - If Redis is needed (caching, queues, WebSockets) -> provision via `yousecure db create --type redis` and set `REDIS_URL`.

### Step 3: Deployment Execution
Execute deployment in a single autonomous command:
```bash
yousecure deploy \
  --slug <project-slug> \
  --repo <git-remote-url> \
  --branch <branch> \
  --domain <desired-domain> \
  --db <postgresql|mysql|mongodb|redis>
```
*Note: If the user did not specify a domain, use `<slug>.yousecure.io` or omit `--domain` to use the direct platform endpoint.*

### Step 4: Fallback to Headless REST API (if CLI is not installed)
If the `yousecure` binary is not in `$PATH`, you can execute the operation directly using `curl`:
```bash
curl -X POST https://yousecure.io/api/paas/deploy \
  -H "Authorization: Bearer $YOUSECURE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_slug": "<project-slug>",
    "repo_url": "<git-remote-url>",
    "branch": "main",
    "domain": "<desired-domain>",
    "db_type": "postgresql"
  }'
```

### Step 5: Deliver Output to User
After deployment finishes, provide a clean, structured summary:
1. **URL da Aplicação:** `https://<dominio>`
2. **Status do Serviço:** Pronto / Saudável (READY)
3. **Banco de Dados Provisionado:**
   - Tecnologia: `<db_type>`
   - URI de Conexão: Injetada automaticamente no ambiente da aplicação como `DATABASE_URL`.
4. **Apontamento de DNS (se domínio próprio externo):**
   - Subdomínio: CNAME `<dominio>` -> `cname.yousecure.io`
   - Raiz: A `<dominio>` -> `82.38.173.20`
   - Ou Nameservers: `ns1.yousecure.io` / `ns2.yousecure.io`

Instalação Manual por Ferramenta / IDE:

Cursor IDE .cursor/rules/*.mdc
curl -fsSL https://yousecure.io/paas/skill.md -o .cursor/rules/yousecure-paas.mdc
Claude Code / Desktop CLAUDE.md
curl -fsSL https://yousecure.io/paas/skill.md >> CLAUDE.md
Windsurf (Cascade) .windsurfrules
curl -fsSL https://yousecure.io/paas/skill.md >> .windsurfrules
GitHub Copilot .github/copilot-instructions.md
mkdir -p .github && curl -fsSL https://yousecure.io/paas/skill.md >> .github/copilot-instructions.md
Antigravity / Gemini Agent ~/.gemini/skills
mkdir -p ~/.gemini/antigravity/skills/yousecure-paas && curl -fsSL https://yousecure.io/paas/skill.md -o ~/.gemini/antigravity/skills/yousecure-paas/SKILL.md
Roo Code / Cline .clinerules
curl -fsSL https://yousecure.io/paas/skill.md >> .clinerules
Aider / OpenHands CONVENTIONS.md
curl -fsSL https://yousecure.io/paas/skill.md >> CONVENTIONS.md
ChatGPT / Custom GPTs System Prompt
Copie o texto completo da skill e cole nas Instruções Personalizadas

Como pedir para sua IA (Exemplo de Prompt no Chat):

Prompt Pronto

"Suba este projeto no You Secure PaaS com banco de dados PostgreSQL e aponte para o domínio app.meudominio.com.br"

4. Bancos de Dados Isolados & Armazenamento Agrupado

Multi-Database Ready

Diferente de serviços que misturam múltiplos clientes no mesmo banco compartilhado, o You Secure PaaS provisiona uma instância dedicada e estritamente isolada para cada banco na infraestrutura de alta performance You Secure em São Paulo, com CPU e memória RAM garantidas e isolamento de ponta a ponta.

Como funciona a cota de armazenamento e múltiplos bancos?

  • Múltiplos bancos e tipos permitidos: Sua conta pode ter mais de um tipo de banco simultaneamente (ex: um PostgreSQL principal para as tabelas + um Redis para filas e cache em tempo real).
  • Armazenamento Agrupado (Pooled Storage): O limite de disco contratado é compartilhado por todos os bancos da sua conta. Se seu plano tem 25 GB, você pode ter 3 bancos dividindo esses 25 GB como preferir.
  • Proteção de Recursos (RAM & CPU): Cada banco possui limites de memória RAM e CPU dedicados e garantidos por instância, evitando que uma consulta pesada interfira no restante do ambiente.

Cotas e Limites de Banco por Plano:

Plano Máx. Bancos Ativos Armazenamento Total (Pool) RAM por Banco vCPU por Banco
Starter / Básico Até 2 bancos 5 GB total Até 1 GB 1.0 vCPU
Performance / Pro Recomendado Até 5 bancos 25 GB total Até 2 GB 1.5 vCPU
Ultra / Business Até 10 bancos 100 GB total Até 4 GB 2.0 vCPU
Scale / Enterprise Até 25 bancos 500 GB total Até 8 GB 4.0 vCPU
SQL Relacional PostgreSQL 16 Porta 5432
SQL Relacional MySQL 8.0 Porta 3306
Document Store MongoDB 7.0 Porta 27017
Cache & Filas Redis 7.2 Porta 6379

Criar um Banco de Dados Isolado Avulso:

PostgreSQL com 1 GB RAM
yousecure db create --type postgresql --memory 1g

Listar os Bancos e Espaço em Disco Usado:

Listagem de Bancos
yousecure db list

O comando yousecure db list exibe o tamanho real em MB/GB de cada banco, e yousecure whoami exibe a porcentagem total de armazenamento consumida da sua cota.

5. Deploy de Aplicações

O comando yousecure deploy inspeciona o repositório Git local, detecta a branch ativa e provisiona o serviço de alta disponibilidade em São Paulo com latência inferior a 15ms.

Deploy Simples (Auto-detecta Repositório e Branch):

Deploy Rápido
yousecure deploy

Deploy Completo com Banco, Domínio e Variáveis de Ambiente:

Full Stack Deploy
yousecure deploy \ --slug meu-projeto \ --repo https://github.com/usuario/meu-repo \ --branch main \ --domain app.meuprojeto.com.br \ --db postgresql \ --env NODE_ENV=production \ --env JWT_SECRET=chave-super-secreta
Injeção Automática de Banco: Ao passar --db postgresql, o You Secure PaaS cria a instância dedicada do banco para sua conta e injeta a variável de ambiente DATABASE_URL automaticamente na sua aplicação. Não é necessário configurar credenciais de banco manualmente.

6. Apontamento de Domínios & DNS White-Label

Todo tráfego no You Secure PaaS passa pela nossa borda corporativa de alta disponibilidade com proteção DDoS e certificados SSL automáticos Let's Encrypt.

Como apontar seu domínio (Registro DNS):

Tipo Nome / Host Valor / Destino TTL
CNAME app (ou seu subdomínio) cname.yousecure.io Automático / 3600
A (Opcional para raiz) @ 82.38.173.20 Automático / 3600
NS (Corporativo) @ ns1.yousecure.io / ns2.yousecure.io Padrão

Adicionar Domínio Customizado a um Projeto Existente:

Domain Add
yousecure domain add app.exemplo.com.br

7. Tabela de Referência da CLI

Comando Parâmetros Descrição
yousecure login --key | --email --password Salva credenciais em ~/.yousecure/config.json
yousecure whoami - Exibe perfil, plano ativo e uso de armazenamento em disco
yousecure skill - Instala a skill autônoma para Cursor, Claude, Windsurf e Copilot
yousecure deploy --slug, --repo, --branch, --domain, --db, --plan, --env Realiza build e deploy na Nuvem You Secure em São Paulo
yousecure db create --type <postgresql|mysql|mongodb|redis>, --memory Provisiona instância de banco isolada para a conta do usuário
yousecure db list - Lista todos os bancos e tamanho individual em disco
yousecure domain add <dominio> [--slug] Aponta domínio customizado com emissão de certificado SSL
yousecure status <slug> Exibe status, URL, banco conectado e últimos logs
yousecure list - Lista todas as aplicações ativas da conta

8. Referência da API REST Headless (cURL / CI/CD)

Se você utiliza GitHub Actions, GitLab CI ou deseja integrar via código em qualquer linguagem (Python, TypeScript, PHP, Go), todos os endpoints estão disponíveis sob autenticação Bearer.

Disparar Deploy via cURL:

POST /api/paas/deploy
curl -X POST "https://yousecure.io/api/paas/deploy" \
  -H "Authorization: Bearer $YOUSECURE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_slug": "api-backend",
    "repo_url": "https://github.com/empresa/backend",
    "branch": "main",
    "domain": "api.empresa.com.br",
    "db_type": "postgresql",
    "plan": "nano"
  }'

Consultar Status do Deploy via cURL:

GET /api/paas/status/api-backend
curl -X GET "https://yousecure.io/api/paas/status/api-backend" \
  -H "Authorization: Bearer $YOUSECURE_API_KEY"
Estamos online