Referência de Comandos

Documentação completa de todos os comandos do CriptEnv CLI, organizados por categoria.

Comandos Core

`criptenv init`

Prepara o diretório ~/.criptenv/ e o banco de metadata local. Este comando é opcional e não cria vault local de secrets nem senha mestra.

bash

criptenv init

`criptenv login`

Autentica com a conta CriptEnv. Armazena o token de sessão localmente.

Parâmetro	Tipo	Descrição
`--email`	`string`	E-mail da conta

bash

criptenv login
criptenv login --email user@example.com

`criptenv logout`

Encerra a sessão atual e remove o token armazenado localmente.

bash

criptenv logout

`criptenv doctor`

Verifica a integridade da configuração local: banco de dados, permissões, conectividade e versão do CLI.

bash

criptenv doctor

Segredos

`criptenv set`

Criptografa e armazena um segredo no vault remoto do projeto. Use a sintaxe KEY=value.

Parâmetro	Tipo	Descrição
`KEY=value`obrigatório	`string`	Chave e valor do segredo
`--env, -e`	`string`	Ambiente de destino
`--project, -p`	`string`	Projeto de destino

bash

criptenv set DATABASE_URL=postgres://user:pass@host/db
criptenv set API_KEY=your_api_key_here -e staging

`criptenv get`

Descriptografa em memória e exibe o valor de um segredo remoto.

Parâmetro	Tipo	Descrição
`KEY`obrigatório	`string`	Nome do segredo
`--env, -e`	`string`	Ambiente de origem
`--project, -p`	`string`	Projeto de origem
`--clipboard, -c`	`boolean`	Copia o valor para a área de transferência

bash

criptenv get DATABASE_URL
criptenv get API_KEY -e production -c

`criptenv list`

Lista todas as chaves do vault remoto sem descriptografar valores.

Parâmetro	Tipo	Descrição
`--env, -e`	`string`	Filtrar por ambiente
`--project, -p`	`string`	Filtrar por projeto

bash

criptenv list
criptenv list -e production

`criptenv delete`

Remove permanentemente um segredo do vault remoto.

Parâmetro	Tipo	Descrição
`KEY`obrigatório	`string`	Nome do segredo a remover
`--env, -e`	`string`	Ambiente de origem
`--force, -f`	`boolean`	Pula confirmação

bash

criptenv delete OLD_API_KEY
criptenv delete DB_PASS -e staging -f

`criptenv rotate`

Cria uma nova versão do segredo. A versão anterior é mantida para referência.

Parâmetro	Tipo	Descrição
`KEY`obrigatório	`string`	Nome do segredo
`--env, -e`	`string`	Ambiente
`--value, -v`	`string`	Novo valor (auto-gerado se omitido)
`--force, -f`	`boolean`	Pula confirmação

bash

criptenv rotate API_KEY
criptenv rotate DB_PASS -e production -v newSecurePass123

Sincronização

`criptenv push`

Importa um arquivo .env para o vault remoto. Sem arquivo, o comando falha com orientação para usar import.

Parâmetro	Tipo	Descrição
`FILE`obrigatório	`string`	Arquivo .env de origem
`--project, -p`	`string`	Projeto específico
`--env, -e`	`string`	Ambiente específico
`--overwrite`	`boolean`	Sobrescreve chaves existentes

bash

criptenv push .env -p <project-id>
criptenv push .env.production -e production -p <project-id> --overwrite

`criptenv pull`

Exporta segredos do vault remoto para um arquivo local. Sem --output, o comando falha com orientação para usar export.

Parâmetro	Tipo	Descrição
`--project, -p`	`string`	Projeto específico
`--env, -e`	`string`	Ambiente específico
`--output, -o`obrigatório	`string`	Arquivo de saída
`--format`	`string`	Formato: env ou json

bash

criptenv pull -p <project-id> --output .env
criptenv pull -e production -p <project-id> -o .env.production

Importação e Exportação

`criptenv import`

Importa segredos de um arquivo .env para o vault remoto.

Parâmetro	Tipo	Descrição
`FILE`obrigatório	`string`	Caminho para o arquivo .env
`--env, -e`	`string`	Ambiente de destino
`--project, -p`	`string`	Projeto de destino
`--overwrite`	`boolean`	Sobrescreve chaves existentes

bash

criptenv import .env
criptenv import .env.production -e production
criptenv import secrets.env --overwrite

`criptenv export`

Exporta segredos do vault remoto para um arquivo .env ou JSON.

Parâmetro	Tipo	Descrição
`--format`	`string`	Formato: env (padrão) ou json
`--env, -e`	`string`	Ambiente de origem
`--project, -p`	`string`	Projeto de origem
`--output, -o`	`string`	Arquivo de saída (padrão: stdout)

bash

criptenv export
criptenv export --format json -o secrets.json
criptenv export -e production -o .env.production

Ambientes

`criptenv env list`

Lista todos os ambientes do projeto.

Parâmetro	Tipo	Descrição
`--project, -p`	`string`	Filtrar por projeto

bash

criptenv env list\ncriptenv env list -p <project-id>

`criptenv env create`

Cria um novo ambiente.

Parâmetro	Tipo	Descrição
`NAME`obrigatório	`string`	Nome do ambiente (ex: staging)
`--project, -p`	`string`	Projeto ao qual pertence
`--display-name, -d`	`string`	Nome legível para humanos

bash

criptenv env create staging -p <project-id>
criptenv env create production -p <project-id> -d "Production Environment"

Projetos

`criptenv projects create`

Cria um novo projeto com senha de vault.

Parâmetro	Tipo	Descrição
`NAME`obrigatório	`string`	Nome do projeto
`--slug`	`string`	Slug opcional do projeto
`--description`	`string`	Descrição do projeto

bash

criptenv projects create meusite
criptenv projects create meusite --description "Backend do MeuSite"

`criptenv projects list`

Lista todos os projetos.

bash

criptenv projects list

CI/CD

`criptenv ci login`

Autenticação headless para ambientes de CI/CD.

Parâmetro	Tipo	Descrição
`--token`obrigatório	`string`	Token de CI/CD (começa com ci_)
`--project`	`string`	ID do projeto

bash

criptenv ci login --token $CI_TOKEN

`criptenv ci logout`

Encerra a sessão de CI/CD.

bash

criptenv ci logout

`criptenv ci secrets`

Lista segredos disponíveis no contexto de CI.

Parâmetro	Tipo	Descrição
`--env, -e`	`string`	Ambiente (padrão: production)
`--project, -p`	`string`	Projeto

bash

criptenv ci secrets -e production

`criptenv ci deploy`

Importa um arquivo de secrets para o vault remoto no contexto de CI.

Parâmetro	Tipo	Descrição
`--file, -f`obrigatório	`string`	Arquivo .env de origem
`--env, -e`	`string`	Ambiente de deploy
`--project, -p`	`string`	Projeto

bash

CRIPTENV_VAULT_PASSWORD="$VAULT_PASSWORD" criptenv ci deploy --file .env.production -e production -p <project-id>

`criptenv ci tokens`

Gerencia tokens de CI/CD.

Lista todos os tokens de CI/CD.

bash

criptenv ci tokens list

Integrações

`criptenv integrations list`

Lista integrações de provedores de nuvem conectadas.

bash

criptenv integrations list

`criptenv integrations connect`

Conecta um novo provedor de nuvem.

Parâmetro	Tipo	Descrição
`PROVIDER`obrigatório	`string`	Provedor: vercel ou render
`--token`	`string`	Token de API do provedor
`--name`	`string`	Nome da integração

bash

criptenv integrations connect vercel
criptenv integrations connect render --token <render-api-key>

`criptenv integrations disconnect`

Desconecta um provedor de nuvem.

Parâmetro	Tipo	Descrição
`PROVIDER`obrigatório	`string`	Provedor a desconectar

bash

criptenv integrations disconnect vercel

`criptenv integrations sync`

Sincroniza segredos do CriptEnv com o provedor conectado.

Parâmetro	Tipo	Descrição
`PROVIDER`obrigatório	`string`	Provedor alvo
`--env, -e`	`string`	Ambiente a sincronizar
`--project, -p`	`string`	Projeto

bash

criptenv integrations sync vercel -e production
criptenv integrations sync render -e production

Manutenção

`criptenv secrets expire`

Define a data de expiração de um segredo.

Parâmetro	Tipo	Descrição
`KEY`obrigatório	`string`	Nome do segredo
`--days, -d`obrigatório	`int`	Dias até expiração
`--policy`	`string`	Política: manual, notify (padrão), auto
`--env, -e`	`string`	Ambiente
`--project, -p`	`string`	Projeto

bash

criptenv secrets expire API_KEY --days 90
criptenv secrets expire DB_PASS --days 30 --policy auto -e production

`criptenv secrets alert`

Configura alertas de expiração para um segredo.

Parâmetro	Tipo	Descrição
`KEY`obrigatório	`string`	Nome do segredo
`--days, -d`obrigatório	`int`	Dias antes da expiração para alertar
`--env, -e`	`string`	Ambiente
`--project, -p`	`string`	Projeto

bash

criptenv secrets alert API_KEY --days 30
criptenv secrets alert DB_PASS --days 14 -e staging

`criptenv rotation list`

Lista segredos com rotação pendente.

Parâmetro	Tipo	Descrição
`--env, -e`	`string`	Filtrar por ambiente
`--project, -p`	`string`	Filtrar por projeto
`--days, -d`	`int`	Dias à frente para verificar (padrão: 30)

bash

criptenv rotation list
criptenv rotation list --days 7 -e production

`criptenv rotation history`

Mostra o histórico de rotações de um segredo.

Parâmetro	Tipo	Descrição
`KEY`obrigatório	`string`	Nome do segredo
`--env, -e`	`string`	Ambiente
`--project, -p`	`string`	Projeto

bash

criptenv rotation history API_KEY
criptenv rotation history DB_PASS -e staging

Info

Para mais detalhes sobre a configuração do CLI, consulte a página de Configuração.