Referência de Comandos

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

Comandos Core

`criptenv init`

Inicializa o diretório ~/.criptenv/, cria o banco de dados SQLite (vault.db) e configura a senha mestra.

Parâmetro	Tipo	Descrição
`--force`	`boolean`	Sobrescreve a configuração existente
`--no-password`	`boolean`	Inicializa sem senha mestra (não recomendado)

bash

criptenv init
criptenv init --force

`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
`--token`	`string`	Token de API (para scripts)
`--browser`	`boolean`	Abre navegador para OAuth (padrão)

bash

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

`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 local. Suporta sintaxe KEY=value ou leitura interativa.

Parâmetro	Tipo	Descrição
`KEY=value`obrigatório	`string`	Chave e valor do segredo
`--env`	`string`	Ambiente de destino (padrão: development)
`--project`	`string`	Projeto de destino
`--expires`	`string`	Duração até expiração (ex: 30d, 1y)

bash

criptenv set DATABASE_URL=postgres://user:pass@host/db
criptenv set API_KEY --env production
criptenv set SECRET_TOKEN=s3cret --expires 90d

`criptenv get`

Descriptografa e exibe o valor de um segredo.

Parâmetro	Tipo	Descrição
`KEY`obrigatório	`string`	Nome do segredo
`--env`	`string`	Ambiente de origem (padrão: development)
`--project`	`string`	Projeto de origem
`--copy`	`boolean`	Copia o valor para a área de transferência
`--version`	`number`	Versão específica do segredo

bash

criptenv get DATABASE_URL
criptenv get API_KEY --env production --copy
criptenv get SECRET_TOKEN --version 2

`criptenv list`

Lista todas as chaves do vault (nunca exibe os valores).

Parâmetro	Tipo	Descrição
`--env`	`string`	Filtrar por ambiente
`--project`	`string`	Filtrar por projeto
`--json`	`boolean`	Saída em formato JSON

bash

criptenv list
criptenv list --env production
criptenv list --json

`criptenv delete`

Remove permanentemente um segredo do vault.

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

bash

criptenv delete OLD_API_KEY
criptenv delete DB_PASS --env staging --force

`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`	`string`	Ambiente
`--value`	`string`	Novo valor (se omitido, solicita interativamente)

bash

criptenv rotate API_KEY
criptenv rotate DB_PASS --env production --value newSecurePass123

Sincronização

`criptenv push`

Envia o vault local para a nuvem. Os dados são criptografados localmente antes da transmissão.

Parâmetro	Tipo	Descrição
`--project`	`string`	Sincronizar projeto específico
`--env`	`string`	Sincronizar ambiente específico
`--force`	`boolean`	Sobrescreve conflitos sem perguntar
`--dry-run`	`boolean`	Mostra o que seria enviado sem enviar

bash

criptenv push
criptenv push --env production
criptenv push --dry-run

`criptenv pull`

Baixa segredos da nuvem para o vault local.

Parâmetro	Tipo	Descrição
`--project`	`string`	Projeto específico
`--env`	`string`	Ambiente específico
`--force`	`boolean`	Sobrescreve segredos locais
`--dry-run`	`boolean`	Mostra o que seria baixado sem baixar

bash

criptenv pull
criptenv pull --env production
criptenv pull --force

Importação e Exportação

`criptenv import`

Importa segredos de um arquivo .env para o vault.

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

bash

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

`criptenv export`

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

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

bash

criptenv export
criptenv export --format json --output secrets.json
criptenv export --env production > .env.production

Ambientes

`criptenv env list`

Lista todos os ambientes configurados.

Parâmetro	Tipo	Descrição
`--project`	`string`	Filtrar por projeto
`--json`	`boolean`	Saída em JSON

bash

criptenv env list

`criptenv env create`

Cria um novo ambiente.

Parâmetro	Tipo	Descrição
`NAME`obrigatório	`string`	Nome do ambiente (ex: staging)
`--project`	`string`	Projeto ao qual pertence
`--clone-from`	`string`	Clonar segredos de outro ambiente

bash

criptenv env create staging
criptenv env create staging --clone-from development

Projetos

`criptenv projects create`

Cria um novo projeto.

Parâmetro	Tipo	Descrição
`NAME`obrigatório	`string`	Nome 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.

Parâmetro	Tipo	Descrição
`--json`	`boolean`	Saída em JSON

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

bash

criptenv ci login --token $CI_TOKEN

`criptenv ci logout`

Encerra a sessão de CI/CD.

bash

criptenv ci logout

`criptenv ci secrets`

Injeta segredos como variáveis de ambiente no pipeline.

Parâmetro	Tipo	Descrição
`--env`	`string`	Ambiente (padrão: production)
`--project`	`string`	Projeto
`--format`	`string`	Formato: dotenv, json, shell
`--prefix`	`string`	Prefixo para as variáveis

bash

criptenv ci secrets --env production
criptenv ci secrets --format shell --prefix APP_
eval $(criptenv ci secrets --format shell)

`criptenv ci deploy`

Executa deploy com segredos injetados.

Parâmetro	Tipo	Descrição
`--env`	`string`	Ambiente de deploy
`--project`	`string`	Projeto
`--command`obrigatório	`string`	Comando de deploy a executar

bash

criptenv ci deploy --command "npm run deploy"

`criptenv ci tokens`

Gerencia tokens de CI/CD.

Lista todos os tokens de CI/CD.

Parâmetro	Tipo	Descrição
`--json`	`boolean`	Saída em JSON

bash

criptenv ci tokens list

Integrações

`criptenv integrations list`

Lista integrações de provedores de nuvem disponíveis e conectados.

bash

criptenv integrations list

`criptenv integrations connect`

Conecta um novo provedor de nuvem.

Parâmetro	Tipo	Descrição
`PROVIDER`obrigatório	`string`	Provedor (aws, gcp, azure, vercel, netlify)
`--key`	`string`	Chave de API do provedor

bash

criptenv integrations connect vercel
criptenv integrations connect aws --key AKIA...

`criptenv integrations disconnect`

Desconecta um provedor de nuvem.

Parâmetro	Tipo	Descrição
`PROVIDER`obrigatório	`string`	Provedor a desconectar
`--force`	`boolean`	Pula confirmação

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`	`string`	Ambiente a sincronizar
`--project`	`string`	Projeto
`--dry-run`	`boolean`	Mostra o que seria sincronizado
`--direction`	`string`	push ou pull (padrão: push)

bash

criptenv integrations sync vercel --env production
criptenv integrations sync aws --dry-run

Manutenção

`criptenv secrets expire`

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

Parâmetro	Tipo	Descrição
`KEY`obrigatório	`string`	Nome do segredo
`--expires`obrigatório	`string`	Duração até expiração (ex: 30d, 90d, 1y)
`--env`	`string`	Ambiente

bash

criptenv secrets expire API_KEY --expires 90d
criptenv secrets expire DB_PASS --expires 30d --env production

`criptenv secrets alert`

Configura alertas de expiração para segredos.

Parâmetro	Tipo	Descrição
`--before`	`string`	Alertar N dias antes da expiração (padrão: 7d)
`--channel`	`string`	Canal do alerta: email, slack, webhook
`--webhook-url`	`string`	URL do webhook (se canal=webhook)

bash

criptenv secrets alert --before 14d --channel email
criptenv secrets alert --before 7d --channel slack

`criptenv rotation list`

Lista segredos com rotação pendente ou expirados.

Parâmetro	Tipo	Descrição
`--env`	`string`	Filtrar por ambiente
`--project`	`string`	Filtrar por projeto
`--expired`	`boolean`	Apenas segredos já expirados
`--json`	`boolean`	Saída em JSON

bash

criptenv rotation list
criptenv rotation list --expired
criptenv rotation list --env production --json

Info

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