Referência de comandos da CLI · Developers

Autentica a CLI com sua conta de usuário Dailybot (OTP)

Envia um código de uso único ao seu email, verifica e guarda um token de sessão em `~/.config/dailybot/credentials.json`. Se a conta pertence a várias organizações, pergunta para escolher (ou use `--org=<UUID>`).

Flags

• --emailstring— Email para o qual enviar o código.
• --codestring— Código OTP para pular o prompt interativo.
• --orgUUID— Preseleciona uma organização quando o usuário pertence a várias.

Exemplos

dailybot login

dailybot login --email [email protected]

Mostra check-ins pendentes ou testa a credencial ativa

Por padrão: lista check-ins pendentes do usuário autenticado (chama `GET /v1/cli/status/`). Com `--auth`: testa tanto o caminho de sessão quanto o de API key e imprime qual credencial vence — substitui a antiga ideia (nunca lançada) de `dailybot me`.

Flags

• --authboolean— Modo probe de credencial: mostra qual credencial (sessão ou API key) está ativa.
• --jsonboolean— Saída legível por máquina.

Exemplos

dailybot status              # pending check-ins

dailybot status --auth       # which credential is active

dailybot status --auth --json

Publicar um relatório de atividade ou progresso como agente

Envia um relatório de progresso ao Dailybot a partir da sessão atual. Aparece nos painéis da equipe e no chat. Desde a CLI v1.11.0 a resposta inclui um `url` — a CLI imprime um link direto para onde o relatório caiu. Não bloqueante: nunca interrompe o trabalho principal se o relatório falhar.

Arguments

• summarystring · required— A mensagem no estilo standup que descreve o que foi feito e por que importa.

Flags

• --milestoneboolean— Marca este relatório como um marco de conclusão de plano.
• --metadatajson— Objeto JSON com modelo, plano ou outros metadados estruturados.
• --json-datajson— Entregáveis estruturados completed/in_progress/blockers.

Exemplos

dailybot agent update "Shipped the notification preferences UI — users can now control which alerts they receive."

dailybot agent update --milestone "Finished the auth refactor." --metadata '{"model":"claude-opus-4.7"}'

Enviar uma mensagem do bot para usuários, canais ou times

Envolve `POST /v1/send-message/`. Suporta respostas em thread (até 10 por pai, um nível), impersonação do bot via `platform_settings` (só Slack), mensagens ephemeral, URLs de imagem e botões interativos/link. Entrega no Slack, Microsoft Teams, Discord e Google Chat.

Flags

• -u/--userstring (repeat)— Usuário alvo por UUID, email ou id externo.
• -c/--channelstring (repeat)— Id do canal alvo.
• -t/--teamstring (repeat)— UUID de time alvo (todos os membros).
• -m/--textstring— Corpo da mensagem.
• --threadstring— Timestamp/id do pai para responder em uma thread existente.
• --thread-messagestring (repeat, max 10)— Texto de resposta a publicar sob o mesmo pai numa chamada (máx. 10).
• --bot-namestring— Nome custom do bot para essa mensagem (só Slack, máx. 80 chars).
• --bot-icon-urlstring— URL HTTPS do avatar (só Slack). Mutuamente exclusivo com `--bot-icon-emoji`.
• --bot-icon-emojistring— Emoji de avatar, ex. `:rocket:` (só Slack).
• --ephemeralboolean— Só Slack: publica visível somente para os destinos `--user` no canal.
• -i/--image-urlstring— URL HTTPS de imagem a anexar.
• --link-buttonlabel|url (repeat)— Anexa um botão tipo link.
• --buttonlabel|value (repeat)— Anexa um botão interativo (devolve `value` via webhook).
• --skip-time-offboolean— Pular usuários marcados como OOO / de licença.
• -d/--metadatajson (repeat)— Metadados livres mesclados com `default_metadata` do repo.
• --payload-jsonjson— Body JSON cru (avançado). Mescla metadados do repo se faltar.
• -p/--profilestring— Perfil de agente nomeado para resolução de auth.
• --jsonboolean— Saída JSON legível por máquina.

Exemplos

dailybot chat send -c C0123456789 -m "Deploy 4.12.0 shipped ✅"

dailybot chat send -c C0123456789 -m "Release status" --thread-message "Frontend OK" --thread-message "Backend OK"

dailybot chat send -c C0123456789 -m "Rollout complete" --bot-name "Release Bot" --bot-icon-emoji ":rocket:"

dailybot chat send -c C0123456789 -u <user-uuid> --ephemeral -m "You are on-call in 10 minutes"

Editar uma mensagem do bot enviada anteriormente

Reemite `POST /v1/send-message/` com o mesmo `bot_message_id`, editando o original dentro da janela de 72h. Também funciona nos IDs de resposta em thread devolvidos por `dailybot chat send`. Os campos de identidade (`--bot-name`, `--bot-icon-*`) são ignorados na edição — a plataforma mantém a aparência original.

Arguments

• bot_message_idstring · required— O ID retornado por `dailybot chat send` (ou um fornecido pelo cliente).

Flags

• -c/--channelstring (repeat)— Id do canal alvo (mesmo do original).
• -u/--userstring (repeat)— Usuário alvo (mesmo do original).
• -m/--textstring— Novo corpo da mensagem.
• -i/--image-urlstring— Nova URL de imagem.
• --payload-jsonjson— Body JSON cru.
• -p/--profilestring— Perfil de agente nomeado.
• --jsonboolean— Saída JSON legível por máquina.

Exemplos

dailybot chat update release-4.12.0 -c C0123456789 -m "Deploy 4.12.0 — rollback in progress ⚠️"

dailybot chat update "$db/thread-1" -c C0123456789 -m "Frontend: build failed, investigating"

Pergunte ao assistente AI do Dailybot — one-shot ou interativo

Executa uma chat completion contra `POST /v1/cli/chat/completions/`. Com um argumento de mensagem (ou stdin pipe): one-shot. Sem argumentos em TTY: lança um TUI Textual em tela cheia (adicionado na v1.14.0) com slash commands `/help`, `/clear`, `/status`, `/checkins`, `/report`, `/exit`.

Arguments

• messagestring— Mensagem opcional. Quando omitida em TTY, abre o TUI interativo.

Flags

• -s/--session-idstring— Continua um id de sessão anterior.
• --jsonboolean— Saída JSON one-shot.

Exemplos

dailybot ask "Summarize my open standup responses"

echo "Explain the last agent report" | dailybot ask --json

dailybot ask   # opens the full-screen TUI

Hooks de ciclo de vida para o harness do agente — apenas ledger local, sem rede

Hooks determinísticos que o harness do agente chama em session-start, post-commit, em atividade de edição de arquivos, em stop e em dismissal pelo usuário. Todos leem e escrevem apenas o ledger local em `~/.config/dailybot/ledger/`. Adicionado na v1.12.0. Ver [Agent Hooks doc](https://github.com/DailybotHQ/cli/blob/main/docs/AGENT_HOOKS.md).

Arguments

• subcommandsession-start | post-commit | activity | stop | dismiss · required— Qual hook invocar.

Flags

• -f/--formatclaude | cursor | generic— Formato de saída para o harness (session-start / stop).
• -m/--minutesint— Para `hook dismiss`: duração do snooze em minutos (padrão 60).

Exemplos

dailybot hook session-start -f cursor

dailybot hook dismiss -m 120

Atualiza a CLI in-place usando o método de instalação detectado

Detecta como a CLI foi instalada (pipx / pip / uv / Homebrew / installer / binário) e atualiza com a ferramenta correspondente. Verifica a nova versão após instalar. Adicionado na v1.4.0.

Flags

• --dry-runboolean— Imprime o que faria sem alterar nada.
• --forceboolean— Pula a confirmação interativa.

Exemplos

dailybot upgrade

dailybot upgrade --dry-run

Desinstala a CLI usando o método de instalação detectado

Remove a CLI de forma limpa, respeitando a origem da instalação (pipx / pip / uv / Homebrew / installer). Por padrão mantém `~/.config/dailybot/` (sessões, ledger, perfis); use `--purge` para removê-lo também. Adicionado na v1.6.0.

Flags

• -y/--yesboolean— Pula o prompt de confirmação.
• --purgeboolean— Também apaga `~/.config/dailybot/` (sessões, ledger, perfis).
• --dry-runboolean— Imprime o que faria sem alterar nada.

Exemplos

dailybot uninstall

dailybot uninstall --purge -y

Imprime a versão da CLI e opcionalmente consulta o PyPI

Painel com a versão, runtime do Python e um link para a release do GitHub. Com `--check`, consulta o PyPI para comparar com a última release.

Flags

• -c/--checkboolean— Consulta o PyPI e compara.

Exemplos

dailybot version

dailybot version --check