Todos os comandos
contextcode --help lista todos; contextcode <comando> --help mostra as opções de um deles.
O agente
Seção intitulada “O agente”| Comando | O que faz |
|---|---|
contextcode chat | Chat interativo no terminal. Usa uma interface de tela cheia se o terminal for interativo, e um REPL simples se a saída for para um arquivo; --tui e --plain forçam cada um. Aceita --modelo, --cwd e --continuar. |
contextcode run "<prompt>" | Um turno do agente e sai. Ideal para scripts e tarefas agendadas. Aceita --modelo. |
Conta e motor de IA
Seção intitulada “Conta e motor de IA”São duas coisas diferentes e se confundem com frequência: login é a sua conta do Context Code; provider é o modelo de IA que o agente usa.
| Comando | O que faz |
|---|---|
contextcode login [--email <e-mail>] | Faz login da licença. É a única via em um servidor sem tela. |
contextcode login --status | Estado da licença, sem pedir nada. |
contextcode logout | Esquece as credenciais deste computador (não cancela a assinatura). |
contextcode provider login <provedor> [--key] | Conecta o motor de IA: claude, gemini-api, openai, copilot, zai, ollama… Com --key sem valor, pede a chave sem exibi-la; --key - a lê do stdin. |
contextcode provider status | Provedores configurados e qual está ativo. |
contextcode modelos [--json] | Modelos disponíveis por provedor, com o ativo marcado. |
contextcode modelos usar <id> | Define o modelo que chat e run usam, o mesmo do seletor do aplicativo. |
contextcode uso [hoy|semana|mes|todo] | Tokens e custo, como o painel de uso. |
contextcode status | Quais runtimes empacotados (Node, uv, npx) serão usados de verdade. |
Acesso remoto: serve
Seção intitulada “Acesso remoto: serve”Sobe o servidor web que o celular escaneia, sem abrir janela. Fica rodando até você cortar com Ctrl+C (ou para sempre, com --install).
| Opção | O que faz |
|---|---|
--print-qr | Desenha o QR do link no terminal. Com URL pública, o QR é o dela e a URL da rede local vai embaixo. A URL sai por stdout e os avisos por stderr, então contextcode serve --print-qr | head -1 dá a URL limpa. |
--public | Publica por um túnel público em vez do IP da rede local. Usa a URL fixa da máquina se tiver ou puder pedir; se não, um túnel temporário cuja URL muda a cada início. Indispensável em um VPS. |
--stable | Como --public, mas sempre com a URL fixa da máquina. Exige o plano com servidores remotos. |
--port N | Porta de escuta (por padrão 8787, ou a do link salvo). |
--bind 127.0.0.1 | IP de escuta. Atrás de nginx, caddy ou um túnel SSH, para não expor a porta em aberto. |
--minutes N | Vida do link novo, de 1 a 43 200 minutos (30 dias). |
--token-file <caminho> | Token estável em um arquivo com permissões 0600, sem depender do chaveiro do sistema. É o que o serviço usa. |
--install | Instala o serve como serviço do usuário (systemd no Linux, LaunchAgent no macOS, tarefa agendada no Windows) e o inicia. Ao terminar, imprime a URL e o QR que o serviço vai usar. |
--uninstall | Para e remove o serviço. |
| Comando | O que faz |
|---|---|
contextcode dispositivos [--json] | Celulares pareados: nome, id, pareado, último uso e IP. |
contextcode dispositivos revocar <id|nome> | Retira o acesso na hora, mesmo com o servidor rodando. --todos para todos, --si sem confirmação. |
Como deixar como serviço, qual URL o QR leva e o que verificar se o celular não conecta: Acesso remoto a partir de um servidor.
Conectar-se a OUTRO Context Code
Seção intitulada “Conectar-se a OUTRO Context Code”| Comando | O que faz |
|---|---|
contextcode remoto agregar <nome> <url> [--token T] | Cadastra um Context Code remoto e se emparelha com ele. |
contextcode remoto listar [--json] | Os remotos configurados. Nunca imprime credenciais. |
contextcode remoto usar <nome> | Fixa qual é usado quando você não diz o nome. |
contextcode remoto quitar <nome> | Apaga a credencial deste computador. |
contextcode remoto probar [<nome>] | Confere que responde, que a credencial vale e o que há do outro lado. |
contextcode chat --remoto [<nome>] | Chat no terminal contra o agente de outra máquina. |
Todo o detalhe em Outro Context Code daqui.
Canais e automação
Seção intitulada “Canais e automação”| Comando | O que faz |
|---|---|
contextcode canal telegram|slack|whatsapp | Deixa o agente escutando esse canal, sem janela, até Ctrl+C. Aceita --workspace e --model. |
contextcode canal configurar <canal> | Guarda e valida o token do bot, pedindo-o sem exibi-lo. |
contextcode canal estado | Quais canais têm credenciais, sem mostrá-las. |
contextcode automatizaciones listar|crear|borrar|activar|desactivar|ejecutar | As mesmas automações do aplicativo. |
contextcode tick | Uma passada do agendador de automações e sai. É o que a tarefa agendada do sistema invoca. |
Extensões e segredos
Seção intitulada “Extensões e segredos”| Comando | O que faz |
|---|---|
contextcode mcp listar|agregar|quitar|probar | Servidores MCP, nos mesmos escopos do aplicativo. |
contextcode skills listar|instalar|quitar | Skills do projeto e globais. |
contextcode caja listar|guardar|rotar|borrar | O cofre do projeto. Os valores são pedidos sem exibi-los. |
Exemplos e opções em Administrar pelo terminal.
Diagnóstico e manutenção
Seção intitulada “Diagnóstico e manutenção”| Comando | O que faz |
|---|---|
contextcode conexion | Onde está tudo e como eu me conecto — veja a página dele. contextcode conexion --qr mostra de novo o QR do serviço que está rodando. |
contextcode instalar-cli [--mostrar] | Deixa contextcode no PATH onde o instalador não conseguiu. |
contextcode update [--check] | Atualiza o binário (servidores Linux). |
Códigos de saída
Seção intitulada “Códigos de saída”| Código | Significa |
|---|---|
0 | Sucesso (também --help e --version). |
1 | A ação foi executada, mas falhou. |
2 | Uso incorreto: argumento desconhecido ou falta um valor. |
Sem nenhum comando, contextcode inicia o aplicativo de desktop; com --minimized, oculto na bandeja.
Assistente da documentação
Responde só com o manual do Context Code
Olá. Pergunte como usar o Context Code e eu respondo com o que diz esta documentação, com links para as páginas.
Estou ouvindo…
Fale normalmente. Quando fizer uma pausa, respondo em voz alta.
Pode errar: confirme os detalhes nas páginas indicadas. 0/500