⌨️Referência da linha de comando

O maxxing é instalado em /usr/local/bin. Execute maxxing <command> --help para ver todas as opções.

Servidor e configuração

Comando	Finalidade
`maxxing serve [--host IP] [--port N]`	executa o servidor web (usado pelo serviço `claude-maxxing`)
`maxxing setup-link [--reset]`	mostra o link de configuração de uso único; `--reset` esquece a senha e reinicia a configuração
`maxxing password`	define uma nova senha da interface (interativo)
`maxxing 2fa status\\|off\\|forget-browsers`	login em duas etapas com o Telegram: estado, desativar (o caminho de volta quando o Telegram não responde), fazer todos os navegadores pedirem de novo
`maxxing status [--json]`	versão, URL, serviço, autenticação do Claude, Telegram, backup, caminhos
`maxxing doctor [--json] [--live] [--offline] [--deps]`	verifica a instalação; `--live` faz uma chamada real ao Claude, `--offline` pula as verificações de atualização (GitHub, versão do Claude Code), `--deps` também procura vulnerabilidades conhecidas nos pacotes instalados (osv.dev)
`maxxing harden [--undo] [--no-restart]`	aplica (ou remove) o sandbox do systemd no serviço e depois o reinicia; restaura as configurações anteriores se o serviço não voltar (veja Segurança)

maxxing init

Cria ou atualiza a configuração, o workspace, as skills e as tarefas padrão. Pode ser executado de novo sem risco: os valores e arquivos existentes são mantidos, a menos que você passe uma opção. Os modelos do workspace (projetos padrão general, system, tutorial) são copiados somente quando estão faltando, e um projeto ou tópico padrão que você apagou nunca é recriado. As tarefas padrão são criadas uma única vez cada (Memory compaction, Check for updates, Morning tasks e Renewal reminder desativadas).

Opção	Efeito
`--workspace PATH`	pasta do workspace (padrão `/root/maxxing`)
`--files-root PATH`	raiz da página Arquivos (padrão: pasta pessoal)
`--port N`	porta HTTP (padrão 8787)
`--bind IP`	`127.0.0.1` ou o IP do Tailscale; endereços públicos são recusados
`--public-url URL`	por exemplo `https://ui.example.com`; `""` apaga o valor
`--timezone TZ`	nome IANA (padrão: o fuso do sistema). Mantenha igual ao fuso do sistema (`timedatectl`), que o cron usa, a menos que o relógio do servidor seja mantido
`--system-clock follow\\|keep`	`follow`: mudar o fuso horário na interface também muda o fuso do sistema; `keep`: nunca mexe nele (servidor compartilhado), as tarefas verificam o horário no seu fuso
`--claude-dir PATH`	pasta do Claude Code para o Harness Maxxing (padrão `~/.claude`; `""` = voltar a ela). Outra pasta o mantém separado de um Claude Code já usado no servidor (passada às sessões como `CLAUDE_CONFIG_DIR`)
`--language en\\|fr`	idioma da interface
`--secret-from-stdin NAME`	guarda um segredo lido da entrada padrão: `claude_oauth_token`, `anthropic_api_key`, `github_update_token`
`--no-crons`	não cria as tarefas padrão
`--quiet`, `--json`	controle da saída

Exemplo: printf %s "$TOKEN" | maxxing init --quiet --secret-from-stdin claude_oauth_token.

Reinicie o serviço depois de alterar a porta, o endereço de bind ou a URL pública: systemctl restart claude-maxxing.

maxxing update

Opção	Efeito
(nenhuma)	busca a nova versão, reaplica suas personalizações por cima, sincroniza as dependências, atualiza skills/modelos, reinicia, verifica se o serviço responde (senão, reverte) e mostra o changelog. Códigos de saída: `0` concluído, `3` conflito nas personalizações (nada foi alterado: adapte-as e use `--resume`), `4` revertido, `1` outro erro
`--resume`	termina uma atualização depois de você adaptar as personalizações à mão (rebase concluído)
`--rollback`	volta ao código que rodava antes da última atualização (recusa, sem alterar nada, enquanto a pasta do código tiver alterações não salvas)
`--branch B`	muda para a branch `B` e passa a segui-la
`--check`	apenas verifica: versão instalada vs. a mais recente e as linhas do changelog entre elas. Não altera nada; código de saída 0 haja ou não atualização, 1 somente quando a verificação falha
`--check --notify`	também envia uma mensagem no Telegram (thread Crons) quando há atualização disponível; nada acontece se o Telegram não estiver configurado. Usado pela tarefa semanal "Check for updates"
`--check --json`	resultado legível por máquina `{ok, current, latest, behind, available, changelog, ...}`
`--no-restart`	não reinicia o serviço
`--preflight`	simula a atualização em uma cópia descartável: para cada personalização, segue sem mudanças / em código que mudou / agora incluída / conflitos, além de edições não salvas, edições feitas pela interface web, extensões que a nova versão não suporta, notas de atualização a aplicar e um veredito (`simple` ou `adapt`). Não altera nada; `--json` para saída legível por máquina
`--verify`	verifica se todas as extensões carregam e se todos os widgets respondem, e executa a verificação de cada personalização. Saída `0` tudo funciona, `1` há algo a corrigir
`--smart`	usado pelo botão Atualizar: depois da reinicialização, o servidor abre uma sessão `system/harness` que aplica as notas de atualização

Toda instalação busca a nova versão em seu remoto git (um fork privado ou espelho: com o token de leitura guardado como github_update_token). Um servidor instalado com uma chave antes da 2.0.0a87 passa sozinho primeiro para o repositório git público (veja Licença). Depois de uma atualização, o comando lista as notas de atualização do workspace das versões instaladas (<code>/docs/upgrade/<version>.md): instruções para o Claude adaptar o seu workspace. O caminho mais fácil é o tópico system/harness (system/update em servidores mais antigos): diga "atualizar" e o Claude verifica, explica, atualiza depois do seu sim e então aplica essas notas.

Somente atualizações assinadas (opcional). Defina "update_verify_signature": true em /var/lib/claude-maxxing/config.json e o maxxing update só instalará uma nova versão se o commit dela, ou uma tag que aponte para ele, tiver uma assinatura válida de uma chave em que o git confia neste servidor (git verify-commit / git verify-tag: importe a chave GPG do mantenedor com gpg --import, ou aponte gpg.ssh.allowedSignersFile para a chave SSH dele). Caso contrário, a atualização para antes de alterar qualquer coisa (código de saída 1, um aviso no feed de notificações e no Telegram) e a versão atual continua rodando. O maxxing doctor informa se a última versão buscada passa na verificação. Desativado por padrão.

maxxing license

Comando	Efeito
`maxxing license status [--json]`	a chave Enterprise opcional deste servidor (tipo, e-mail, data de término) e de onde vêm as atualizações
`maxxing license activate [HM-…]`	registra uma chave Enterprise, verificada pelo servidor de licenças (pedida de forma oculta; `--key-from-stdin` a lê da entrada padrão)
`maxxing license remove`	esquece a chave e libera o lugar dela na licença
`maxxing license release`	libera o lugar da chave sem esquecê-la

Veja Licença.

maxxing video, maxxing pdf

Comando	Efeito
`maxxing video new DIR`	cria um projeto Remotion em DIR (node_modules ligado à instalação compartilhada)
`maxxing video status`	Node.js, Remotion e o navegador headless neste servidor (saída 1 se não estiver pronto)
`maxxing pdf IN.html OUT.pdf`	converte um arquivo HTML ou uma URL `https://` em PDF (A4, com fundos)
`scrapling extract get\\|fetch\\|stealthy-fetch URL OUT.md`	busca uma página (HTTP / navegador / navegador furtivo) e a converte em Markdown, texto ou HTML
`scrapling-python SCRIPT.py`	executa um script de scraping com o Scrapling e o navegador dele
`bash /opt/claude-maxxing/install.sh --tools`	(re)instala Node.js, Chromium, Remotion e Scrapling (= `maxxing deps update`)

maxxing import

Comando	Efeito
`maxxing import --prompt [hermes\\|claude-code\\|openclaw\\|other]`	mostra o prompt para dar ao seu agente antigo
`maxxing import ZIP --dry-run [--json]`	mostra o que seria importado
`maxxing import ZIP [--json]`	importa (nada é sobrescrito; veja Importação)

maxxing custom

Alterações feitas no código do produto, registradas para que as atualizações as preservem (veja Personalização).

Comando	Efeito
`maxxing custom` / `status [--json]`	personalizações, alterações não salvas na pasta do código, atualização pendente
`maxxing custom save "TITLE" --why "REASON" [--files F…] [--check "CMD"]`	faz o commit das alterações pendentes como uma personalização (recusado em `web/`); `--check` = um comando que tem sucesso enquanto tudo funciona, executado após cada atualização
`maxxing custom check ID "CMD"`	define (ou apaga com `""`) a verificação de uma personalização
`maxxing custom drop ID`	remove uma personalização
`maxxing custom export`	reescreve `<workspace>/CUSTOMIZATIONS.md` e `customizations/*.patch`
`maxxing custom restore [--from DIR]`	reaplica os patches salvos (novo servidor)

maxxing deps

Os componentes externos (server/maxxing/deps.toml: uv, Python, Node.js, Claude Code, Caddy, Scrapling, Chromium, Remotion, os modelos Whisper, Garage). Como root.

Comando	Efeito
`maxxing deps list [--json]`	versão instalada e esperada de cada um (saída 1 quando algum está faltando ou desatualizado)
`maxxing deps verify [NAME...]`	checksums dos binários instalados, arquivos que não pertencem ao root ou que outros podem gravar
`maxxing deps update [NAME...] [--notify]`	instala as versões fixadas ao lado das antigas e troca quando elas funcionam (todo `maxxing update` faz isso)
`maxxing deps remove NAME [--force]`	apaga o que o manifesto lista para ele (`--force` para uv, Python, Claude Code)
`maxxing deps clean [--dry-run] [--caches]`	versões antigas, navegadores não usados, sobras, logs grandes demais (tarefa semanal); `--caches` também esvazia os caches de uv / npm / pip / npx do root, compartilhados com as outras ferramentas do servidor
`maxxing deps check [--notify]`	vulnerabilidades conhecidas (osv.dev) nos lockfiles e componentes (tarefa semanal, notificação)

maxxing uninstall

Opção	Efeito
(nenhuma)	remove o serviço, o site do Caddy, o bloco gerenciado do crontab, as skills do produto e `/usr/local/bin/maxxing`; mantém o código, o estado e o workspace
`--purge`	também apaga o código (`/opt/claude-maxxing`), o estado (`/var/lib/claude-maxxing`) e os componentes externos de `deps.toml` (uv, Node.js, as ferramentas; Claude Code e Caddy quando foi o instalador que os instalou; o arquivo de swap dele)
`--purge-workspace`	também apaga o workspace (irreversível)
`--yes`	não pede confirmação

Tarefas agendadas

Comando	Finalidade
`maxxing cron list`	tarefas, horários, últimos resultados
`maxxing cron run <id>`	executa uma tarefa agora no seu terminal e espera terminar; `--detach` a inicia em uma unidade systemd própria, com os limites de memória, e retorna (é o que o crontab chama); `--if-due` a executa somente se o horário agendado coincide com o momento atual no seu fuso (relógio do servidor mantido)
`maxxing cron sync`	reescreve o bloco gerenciado do crontab a partir da lista de tarefas

Feed de notificações

Comando	Finalidade
`maxxing feed post "Title" [--body] [--level info\\|success\\|warning\\|error] [--source NAME] [--url] [--dedupe KEY] [--group KEY] [--quiet] [--json]`	adiciona um evento (painel e Telegram, conforme a regra da fonte); `--dedupe` ignora uma repetição, `--group` agrupa as repetições
`maxxing feed list [--unread] [--source] [--limit] [--json]`	últimos eventos
`maxxing feed read-all`	marca tudo como lido
`maxxing packs list [--json]`	projetos iniciais e se estão instalados
`maxxing packs add ID [ID...] [--json]`	adiciona projetos iniciais (nunca sobrescreve: só os arquivos que faltam são adicionados; tarefas criadas desativadas)

Chaves

Comando	Finalidade
`maxxing keys list [--json]`	nomes, notas e se cada chave está exposta (nunca os valores)
`maxxing keys get NAME`	mostra um valor (código de saída 1 se não existir)
`printf %s "$VALUE" \\| maxxing keys set NAME [--note TEXT] [--no-expose]`	cria ou atualiza uma chave; o valor vem da entrada padrão, nunca da linha de comando. Uma chave nova é exposta (variável de ambiente de todas as sessões e tarefas de shell), a menos que use `--no-expose`; uma atualização mantém a nota e a exposição
`maxxing keys delete NAME`	remove uma chave
`maxxing infra status` / `infra list [--kind K] [--json]`	o inventário de Infra: fontes, problemas, cada site / banco de dados / bucket / domínio / servidor (último snapshot)
`maxxing infra refresh`	lê tudo agora (este servidor, outros servidores por SSH, Cloudflare, Hostinger, verificações de URL)
`maxxing infra site add NAME (--dir D \\| --port N) [--host H] [--dns] [--project P]`	coloca um site no ar: `https://<Harness address>/<NAME>/` (em sandbox) ou em um host próprio; `site remove`, `site list`, `reserved`
`maxxing infra db install` / `db create NAME` / `db sqlite PATH` / `db backup`	PostgreSQL em localhost, um banco de dados + usuário por app (URL no cofre como `DB_<NAME>_URL`), backups noturnos
`maxxing infra bucket install` / `bucket create NAME [--public]`	buckets S3 neste servidor (Garage), chaves no cofre como `S3_<NAME>_*`
`maxxing infra server add NAME HOST [--user U] [--key K]`	lê outro servidor por SSH (`server remove`, `server list`)
`maxxing infra annotate ID [--project P] [--note T] [--hide\\|--show]`	associa um recurso a um projeto, adiciona uma nota, oculta

Os scripts leem as chaves do ambiente (os.environ["NAME"], $NAME); um script que renova um token (um token de loja de 24 horas, um segredo de webhook que acabou de criar) o grava de volta com maxxing keys set.

Servidores MCP

Comando	Finalidade
`maxxing mcp list [--json] [--no-check]`	todos os servidores MCP do Claude Code, onde se aplicam e seu estado (pergunta primeiro ao Claude Code, alguns segundos)
`maxxing mcp add NAME URL [--where projects/P/topics/T] [--header 'Name: value'] [--sse]`	adiciona um servidor pelo endereço, para todas as sessões ou para um tópico; segredos como `${KEY}` do cofre
`maxxing mcp add NAME --command 'npx -y pkg' [--env KEY=VALUE] [--where …]`	adiciona um programa local
`maxxing mcp remove NAME [--where …]`	remove-o

Os logins por OAuth (estado "To connect") são feitos em Configurações -> MCP -> Conectar. Veja Servidores MCP.

Memória e sessões

Comando	Finalidade
`maxxing memory [--json]`	cada memory.md com o número de linhas e o limite de linhas (Configurações -> Memória)
`maxxing sessions compact-logs [--dry-run]`	corta as saídas de ferramentas dos logs de sessões existentes e remove as listas volumosas de inicialização do Claude e as linhas de progresso (libera espaço em disco; `--dry-run` apenas informa o que seria economizado)
`maxxing sessions token-report [--days N] [--json]`	para onde vão os tokens das suas sessões, lido das transcrições do Claude Code: tamanho do contexto por chamada, cache reescrito após uma hora parado ou uma troca de modelo, as ferramentas cujas saídas enchem o contexto e o que a compactação automática em 400k / 300k / 250k / 200k teria economizado nas mesmas chamadas

Backup

Comando	Finalidade
`maxxing backup status [--json]`	configuração e última execução
`maxxing backup run`	faz o backup agora (código de saída 2 se um segredo foi encontrado)
`maxxing backup restore [--ref COMMIT]`	restaura os arquivos da lista permitida
`maxxing backup restore --from OWNER/NAME [--token T]`	novo servidor: configura um repositório de backup existente e depois restaura (token também em `$MAXXING_GITHUB_TOKEN`)

Comando	Finalidade
`maxxing telegram status [--json]`	bot, chat, threads, configurações, último erro
`maxxing telegram test`	envia uma mensagem de teste
`maxxing voice status [--json]`	mensagens de voz: mecanismo, modelo, prontidão
`maxxing voice set [--engine] [--model] [--language]`	altera as configurações de voz
`maxxing voice download [model]`	baixa um modelo local de reconhecimento de fala
`maxxing voice transcribe <file>`	transcreve um arquivo de áudio com o mecanismo configurado

Instalador

curl -fsSL https://get.harness-maxxing.com | bash          # install / repair (from the public git repository, no key)
bash /opt/claude-maxxing/install.sh --update                # = maxxing update
bash /opt/claude-maxxing/install.sh --uninstall [--purge] [--purge-workspace]
bash /opt/claude-maxxing/install.sh --tools                 # (re)install Node.js, Chromium, Remotion, Scrapling (= maxxing deps update)
SOURCE_DIR=/path/to/copy bash /path/to/copy/install.sh      # install a local copy of the code (no download)
bash /opt/claude-maxxing/install.sh --secure                # security updates, fail2ban, firewall (FIREWALL=0: no firewall)
curl -fsSL https://get.harness-maxxing.com | bash -s -- --check   # look at the server first, change nothing

Variáveis: veja Instalação.

Variáveis de ambiente

Variável	Uso
`MAXXING_STATE`	diretório de estado (padrão `/var/lib/claude-maxxing`); definida pelo serviço e pelo wrapper da CLI
`MAXXING_GITHUB_TOKEN`	token para `maxxing backup restore --from`
`NO_COLOR`	saída sem cores