Iniciar uma tarefa

A caixa de entrada no topo da tela (omnibox) é o ponto de partida para qualquer registro.

Tarefa em execução

Enquanto uma tarefa estiver em andamento, ela aparece na primeira seção com o timer ativo e todos os controles disponíveis.

Ao parar: Concluída ou Pendente

Parar não é um clique só. O card troca a linha do cronômetro por um campo HH:MM com a hora atual e dois botões:

• Concluída: a tarefa foi até o fim. Se ela veio de uma tarefa planejada, a planejada é marcada como concluída no dia.
• Pendente: o registro é salvo, mas a planejada continua aparecendo — você ainda vai voltar a ela.

Se você não tocar no campo de hora, o término é agora. Se digitar um horário anterior, ele vira o fim real e a duração é recalculada — é a saída para o timer que ficou esquecido rodando. Horários anteriores ao início são rejeitados na hora, com aviso no próprio campo. Enter no campo encerra como Concluída, que é a ação primária.

A tarefa em execução em qualquer tela

Enquanto uma tarefa roda, a barra de título da janela mostra um chip com ela — em qualquer tela, não só em Tarefas. O chip ganha o tom da cor de destaque quando a tarefa está rodando e o âmbar quando está pausada.

A tarefa em execução nas listas

A tarefa que está rodando também se destaca onde ela aparece — nas Entradas de hoje, no Planejamento e nas duas abas do Popup Flyout: a linha ganha um fundo tingido e um ponto ao lado do nome. O ponto pulsa enquanto a tarefa roda e fica âmbar quando ela está pausada; ao passar o cursor, ele diz "Em execução" ou "Pausada". Num grupo de tarefas iguais, quem se destaca é o cabeçalho do grupo.

Tarefas planejadas para hoje

Escolher uma planejada na lista inicia o timer já com nome, projeto, categoria e campos personalizados preenchidos. Cada linha tem também o círculo de concluir, à esquerda: clicar nele marca a tarefa como feita no dia sem iniciá-la — ela sai da lista, que mostra só as pendentes. O chip de faturamento continua alternando ali mesmo, sem iniciar a tarefa, e "Ver semana →" leva ao Planejamento. Se a tarefa tiver ações configuradas (abrir URL, abrir arquivo), elas ficam disponíveis como chips clicáveis durante a execução — no card da tarefa em execução, no chip da barra de título e no Popup Flyout. Você dispara cada uma sob demanda, quando precisar.

Totalizadores do dia

As metas diária e semanal são definidas em Configurações → Geral → Jornada. O total da semana conta apenas os dias com registro, e é sempre calculado no seu fuso local.

Entradas de hoje

Cada linha exibe o ponto colorido do projeto, o nome, o subtítulo Projeto · Categoria, o chip de faturamento, a duração e o Play, sempre visível — ele inicia uma nova execução com estes dados. O clique na linha abre o modal de edição, e o menu ⋯ — sempre visível, na primeira coluna da direita, e também pelo clique direito em qualquer ponto da linha — traz as ações da tarefa, quando a entrada veio de uma planejada que tem alguma, mais Editar e Excluir, nesta ordem. Com o foco na linha, Enter inicia, E edita, Del exclui e ↑ ↓ andam entre as linhas. Excluir continua sem confirmação — e dá para desfazer.

Agrupamento de tarefas

Tarefas com mesmo nome + projeto + categoria são agrupadas visualmente. O grupo exibe a duração total e a contagem de registros ao lado do nome. O clique no cabeçalho expande o grupo, para ver e editar cada registro individualmente; as demais ações ficam no menu ⋯ do cabeçalho, que também abre pelo clique direito:

• Editar grupo: altera nome, projeto, categoria e campos personalizados de todas as tarefas do grupo de uma vez. Com o foco no cabeçalho, a tecla E faz o mesmo.
• Mover para workspace: só aparece havendo mais de um workspace.
• Unificar: une todos os registros em um único, somando as durações. O registro começa no início do primeiro e termina no fim do último.

Para repetir o trabalho, use o Play de qualquer registro do grupo: ele inicia uma nova execução com os mesmos dados.

Seleção múltipla

A barra "Selecionar tarefas" liga as caixas de seleção da lista. Com tarefas marcadas você pode excluí-las em massa — o lote também se desfaz — ou, havendo mais de um workspace, movê-las para outro workspace.

Duas colunas, do seu tamanho

O formulário fica numa coluna à esquerda e os apontamentos do dia à direita. A coluna do formulário é ajustável:

• Arraste o divisor entre as duas colunas para dar mais espaço a uma ou a outra. Duplo clique volta à largura padrão; Home também, com o divisor focado pelo teclado.
• Recolha a coluna pelo botão dela — sobra uma faixa estreita com o rótulo de pé, e a lista fica com a tela inteira.
• As duas preferências são salvas por tela. O Planejamento tem as suas, independentes.

Adicionar uma entrada

Campo de duração

Cadeia de horários

Este recurso torna o lançamento retroativo de um dia inteiro muito rápido: você informa apenas o fim (ou a duração) de cada tarefa e o app encadeia os horários automaticamente.

Sugestões do planejamento

Quando há tarefas planejadas para o dia selecionado, elas aparecem em um painel acima do formulário como sugestões de lançamento. O comportamento varia conforme a tarefa tenha ou não horário definido:

O painel de sugestões é redimensionável na vertical: arraste o divisor abaixo dele para ver mais planejadas de uma vez em um dia cheio de reuniões. A altura escolhida é um teto — com duas planejadas o painel continua encolhendo até o conteúdo, em vez de deixar espaço vazio.

Apontamentos do dia

A coluna da direita lista o que já foi registrado no dia selecionado, do mais recente para o mais antigo. O clique na linha abre o modal completo de edição. O menu ⋯ — sempre visível, na primeira coluna da direita — e o clique direito trazem Editar e Excluir (sem confirmação, mas com desfazer). Com o foco na linha, E edita, Del exclui e ↑ ↓ andam entre as linhas.

A barra "Selecionar tarefas", acima da lista, liga as caixas de seleção e habilita duas ações em massa. No modo de seleção a linha volta a servir só para marcar: sem menu, sem clique direito.

• Excluir selecionadas — sem confirmação, e o lote também se desfaz.
• Mover para workspace — só aparece havendo mais de um workspace. Projeto e categoria de mesmo nome são reaproveitados no destino.

A semana é apresentada como um cartão por dia, e o dia de hoje ganha um tom próprio. A pílula "Semana atual" no cabeçalho é indicador e atalho ao mesmo tempo: acesa, você está na semana de hoje; apagada, um clique traz você de volta — e devolve o filtro de dia para "Todos".

A coluna do formulário, à esquerda, recolhe e é arrastável exatamente como a do Lançamento manual — as duas telas compartilham o mesmo arranjo, com preferências salvas independentes.

Tipos de agendamento

Filtro por dia

Ações por tarefa

Cada tarefa planejada pode ter ações associadas a ela, configuradas no formulário de criação, no modal de edição ou no painel de edição do próprio overlay. Você dispara cada uma quando quiser, quantas vezes quiser. Elas não são executadas automaticamente ao iniciar.

Onde as ações ficam

As ações de uma tarefa são a primeira seção do menu ⋯ da linha — o mesmo que o clique direito abre. Elas vêm no topo, antes de Editar e das demais:

• Com uma ação só, ela é o próprio item do menu (Abrir …): o clique abre a URL ou o arquivo direto.
• Com duas ou mais, o menu traz o item Ações, que abre um submenu com uma linha por ação.

Não é preciso dar play nem abrir a edição para disparar uma ação. O menu com as ações aparece em todo lugar onde a tarefa planejada — ou uma tarefa que veio dela — é exibida:

• na linha da tarefa no Planejamento;
• nas abas Planejadas e Executadas do Popup Flyout;
• nas entradas do Histórico que vieram de uma planejada;
• no chip da barra de título, enquanto a tarefa roda — ali continua sendo um raio (⚡), porque o chip não é linha de lista.

Nas tarefas já executadas, o menu oferece as ações atuais da planejada de origem: se você mudou as ações depois, valem as novas; se excluiu a planejada, a seção some. No modo de seleção some o menu inteiro, porque ali o clique na linha serve para marcar.

O nome do chip

A ação tem um campo Nome, opcional. O chip escreve o primeiro destes que existir:

1. O nome que você deu à ação.
2. O destino reconhecido, quando o endereço é de um serviço conhecido — Meet, Zoom, Teams, Google Agenda, Monday, Zendesk.
3. O valor cru: o hostname da URL, ou o nome do arquivo.

As ações criadas pelas integrações já nascem nomeadas pelo destino — "Meet" diz o que o nome da reunião, uma linha acima, não diz. O endereço completo fica sempre no tooltip do chip.

Uma tarefa pode ter múltiplas ações. Cada uma vira um chip independente, na ordem em que foi configurada.

A linha da tarefa planejada

A linha mostra o círculo de concluir, o ponto do projeto, o nome, o subtítulo Projeto · Categoria e, na direita, sempre nesta ordem: o menu ⋯, o chip de faturamento — que é controle, não rótulo: clicar nele alterna —, a duração ou o horário e o Play. A tarefa em execução ganha destaque na própria linha. Nome longo não precisa da edição para ser lido: quando ele não cabe na linha, passar o cursor mostra o texto inteiro — e o mesmo vale para o subtítulo, em todas as listas do app e no popup.

Nada ali aparece só ao passar o cursor. O ⋯ é a primeira coluna da direita e fica sempre visível, no mesmo lugar em toda linha, tenha ela chip ou não — e por isso não cobre mais a duração nem o horário. O que se usa o dia inteiro fica na própria linha; o resto está no menu:

O menu abre pelas ações da tarefa, quando ela tem alguma, e depois traz estes quatro itens — Excluir é sempre o último, longe do cursor que acabou de abrir o menu. Cada um responde também a uma tecla quando a linha está em foco:

Com o foco na própria linha, Enter inicia, Espaço conclui ou reabre e ↑ ↓ andam para a linha vizinha, dentro do cartão do dia.

Concluir e pendente

• Concluir: o círculo à esquerda da linha marca a tarefa como feita no dia atual. Ela deixa de aparecer na lista de planejadas da tela de Tarefas, mas continua existindo no planejamento.
• Pendente: clicar de novo no círculo desfaz a conclusão. A tarefa volta a aparecer como planejada para o dia.

De onde vêm as tarefas planejadas

Além do formulário desta tela, tarefas planejadas chegam por três importações:

Filtros disponíveis

Filtros rápidos

Botões de atalho para os períodos mais comuns:

• Hoje
• Último trabalhado: o último dia com registro antes de hoje — não necessariamente ontem. Numa segunda-feira, em geral é a sexta; atravessa fins de semana, feriados e férias.
• 7 dias
• 30 dias
• Este mês
• Personalizado: abre os filtros avançados para você escolher o período.

Filtros avançados

Resultados

O resultado da busca se divide em abas:

Na aba Tarefas, cada dia fica num cartão. O cabeçalho de cada grupo exibe o dia da semana, a data e o total de horas do dia. Cada grupo pode ser exportado individualmente.

Por tarefa, o clique na linha abre o modal completo de edição, e o menu ⋯ — sempre visível, na primeira coluna da direita, ou pelo clique direito — traz Editar e Excluir (sem confirmação, mas com desfazer). Com o foco na linha, E edita, Del exclui e ↑ ↓ andam dentro do cartão do dia. Quando a entrada veio de uma tarefa planejada com ações, elas abrem o próprio menu, antes do Editar. A barra "Selecionar tarefas" habilita exclusão em massa — que também se desfaz — e, havendo mais de um workspace, Mover para workspace; no modo de seleção a linha serve só para marcar.

Resumo por IA

Com um provedor de IA conectado, o resultado ganha a aba Resumo: um parágrafo curto por dia, descrevendo no que o tempo foi gasto, a partir dos nomes, projetos e durações das tarefas daquele dia.

• Só gera quando você abre a aba. Buscar sem abri-la não consome nada do provedor.
• Até 5 dias por vez, os mais recentes da busca. Se a busca trouxer mais, um aviso no topo do cartão diz isso.
• Dias passados ficam guardados. Buscar de novo a mesma semana mostra os resumos já gerados, sem nova requisição. Hoje é a exceção: como o dia ainda não acabou, o resumo dele é refeito a cada vez.
• Falhas não se repetem sozinhas. Se um dia falhar, ou se o limite do provedor for atingido no meio, a aba mostra o que aconteceu e o botão "Tentar novamente".

Exportar

O botão Exportar resultados abre o modal de exportação sobre o conjunto filtrado. O modal tem duas abas: a de seleção, onde você marca o que exportar (tudo vem marcado), e a de perfil, onde a configuração fica salva para reusar.

Tarefas agrupadas viram um registro único, com a duração somada. Os perfis são por workspace, e há um perfil padrão editável desde o início.

Projetos

Projetos são agrupadores livres — cliente, produto, área de negócio. Cada um tem uma cor, atribuída automaticamente a partir de uma paleta de 24 tons e editável a qualquer momento. É essa cor que vira o ponto ao lado do nome nas listas de tarefas.

Importação em massa

O botão Importar, ao lado das abas, abre a textarea: um projeto por linha. Projetos já existentes são ignorados.

Gerenciar individualmente

• Use o campo de busca, acima do cartão, para filtrar a lista.
• A última linha do cartão é a de cadastro — a lista rola por dentro, então adicionar não custa rolar o catálogo inteiro.
• Excluir projeto remove apenas o cadastro — as tarefas que o referenciavam ficam sem projeto associado.

Seleção múltipla

• Clicar em qualquer ponto da linha alterna a seleção. Renomear e excluir continuam fazendo só o que prometem.
• "Selecionar todos" no cabeçalho do cartão, com estado indeterminado quando a seleção é parcial.
• Excluir selecionados, sem confirmação.

Categorias por projeto

Na linha de cada projeto há uma pílula com a contagem de categorias associadas (ou "todas"). Clicar nela abre o bloco de associação — marque as categorias que fazem sentido naquele projeto e, dali em diante, o autocomplete de categoria oferece só essas em todos os formulários do app.

• Cada clique grava. Não há botão de salvar.
• Sem nenhuma marcada, o projeto oferece o catálogo inteiro. É o estado de todo projeto até alguém marcar algo — o filtro nunca deixa você sem opção.
• "Desmarcar todas" aparece com mais de uma marcada, e é o caminho de volta ao "oferece todas".
• Trocar o projeto de uma tarefa limpa a categoria, já que o conjunto oferecido mudou.

Se você usa o Monday, as associações são semeadas automaticamente a partir dos Activity Types de cada quadro. Elas aparecem marcadas e podem ser removidas, mas a remoção vale até a próxima varredura — para tirar de vez, remova o Activity Type no quadro.

Categorias

Categorias classificam a natureza do trabalho e determinam o padrão de faturamento (billable / non-billable).

Importação em massa

Cole uma lista de categorias na textarea (uma por linha). Use o prefixo ! para marcar uma categoria como non-billable. Sem prefixo = billable.

Gerenciar individualmente

• Adicione na última linha do cartão, com toggle de billable ao lado do nome.
• Excluir categoria não afeta as tarefas já registradas com ela.
• Seleção múltipla e exclusão em massa funcionam como em Projetos.

Aba Workspaces

Criar, renomear, recolorir, tornar ativo e excluir workspaces. O funcionamento completo está em Workspaces.

Aba Campos

Criar e ordenar os campos personalizados que aparecem em toda tarefa e planejada.

Para que servem

O caso típico é separar trabalho de uso pessoal, ou um cliente de outro. Sem workspaces, o catálogo de projetos de um contexto polui o autocomplete do outro, e os totalizadores somam horas que não deveriam se somar.

Criar e gerenciar

Tudo acontece em Dados → Workspaces.

O modal de exclusão também avisa quais integrações param junto: uma integração apontada para o workspace excluído deixa de rodar em silêncio, porque a busca simplesmente não devolve nada e não há erro a exibir. O aviso não impede a exclusão — depois basta escolher outro workspace em Integrações.

Trocar de workspace

O seletor está em três lugares: no rodapé da sidebar, no chip do cabeçalho do Popup Flyout e — como duas faixas coloridas nas bordas — no Compact Overlay. Todas as janelas se sincronizam na troca.

Mover tarefas entre workspaces

Nas três listas de tarefas — Entradas de hoje, Lançamento manual e Histórico — a barra "Selecionar tarefas" oferece Mover para workspace. Projeto e categoria de mesmo nome são reaproveitados no destino; não havendo, a tarefa chega sem eles.

Integrações têm workspace próprio

Cada integração escolhe em qual workspace do DeskClock ela trabalha, no primeiro controle do card dela em Integrações. É esse workspace que define o destino das importações e o recorte do envio — e ele vale independentemente de qual workspace está aberto na tela naquele momento.

Sem isso, dois defeitos silenciosos apareciam: uma importação nascia onde a pessoa estivesse no instante do ciclo automático, e o envio mandava ao board do cliente a hora do trabalho pessoal. No envio por tarefa, a tarefa de outro workspace é simplesmente pulada, sem aviso — não há nada de errado nela.

Tipos disponíveis

Onde eles aparecem

• No formulário do Lançamento manual, com rótulo flutuante — ele começa dentro do campo e sobe para a borda ao receber foco, para continuar legível depois de preenchido.
• No formulário e no modal de edição do Planejamento.
• Na tarefa em execução — tanto na barra da tela de Tarefas quanto no painel de edição do Popup Flyout.
• No modal de edição de tarefa e no de edição de grupo.
• Como colunas na exportação.

Criar e ordenar

Em Dados → Campos. A ordem definida ali é a ordem em que eles aparecem em todos os formulários.

Modos de envio automático

O rail de integrações

A faixa estreita à direita, presente em todas as telas, mostra uma placa por integração conectada, com o logo oficial de cada serviço. Passar o cursor abre um flyout com as ações daquela integração, sem precisar navegar até a tela de Integrações:

Como só aparecem as integrações conectadas, a placa não precisa de indicador de estado — o flyout confirma com "Conectado". O Monday só entra no rail quando está configurado de ponta a ponta. O rail pode ser desligado em Configurações → Geral.

Workspace por integração

Havendo mais de um workspace, o primeiro controle de cada card é Workspace DeskClock. Ele decide onde as importações caem e quais tarefas entram no envio, independentemente do workspace aberto na tela.

Quando parte do envio não passa

Um envio leva vários grupos de tarefas, e a recusa é por grupo. O DeskClock marca como "Enviado" apenas o que o destino confirmou — o que ficou para trás continua na fila do próximo envio, sem duplicar o que já subiu.

Google Sheets

Google Calendar

Após conectar o Google, o modal "Importar eventos" fica disponível no rail de integrações e no card do Google, na tela de Integrações. Você escolhe o período num campo único, com atalhos ao lado do calendário (Esta semana, Próxima semana, Semana passada, Este mês), e os eventos são exibidos em um accordion de dois níveis — semana e dia — permitindo selecionar quais importar e configurar projeto, categoria e recorrência para cada um.

Pré-mapeamento automático

Se a descrição do evento no Google Agenda contiver as linhas Projeto: Nome do Projeto ou Categoria: Nome da Categoria (sem distinção de maiúsculas), o DeskClock preenche os campos automaticamente ao importar. Isso elimina o mapeamento manual para eventos recorrentes.

Eventos ignorados

Evento que é só lembrete — um recorrente que não é trabalho — pode ser ignorado pelo nome, para não virar tarefa planejada toda semana. Cada regra compara o nome do evento de um de dois jeitos, sem distinguir maiúsculas:

• Igual: o nome do evento é exatamente o texto da regra.
• Contém: o nome do evento contém o texto da regra em qualquer ponto.

Há dois lugares para criar uma regra: a lista "Eventos ignorados", no card do Google, e o botão "Ignorar sempre" em cada evento do modal "Importar eventos", que cria uma regra Igual com o nome daquele evento. Para remover, clique no X ao lado da regra, na lista.

O evento ignorado some do rastreamento automático e, no "Importar eventos", aparece desmarcado, com o selo "Ignorado" — ainda dá para marcá-lo e importar naquela vez.

Rastreamento automático de reuniões

Ative "Rastrear reuniões automaticamente" no card do Google (requer conta conectada) para que o DeskClock acompanhe sua agenda sem intervenção. Ao abrir o app e a cada 2 minutos, ele busca os eventos com horário do dia, importa como tarefas planejadas (sem duplicar as já existentes) e, no horário de cada reunião, exibe um aviso junto ao overlay perguntando se deseja iniciar a tarefa.

• Início: o aviso aparece até 1 minuto antes do horário do evento. Ao confirmar, a tarefa começa — se já houver uma tarefa em execução, ela é finalizada e a da reunião assume.
• Fim: ao chegar o horário de término, o app não para sozinho — pergunta se a reunião ainda está em andamento. Se estiver, ele volta a perguntar a cada 15 minutos até você encerrar.
• Projeto, categoria e campos personalizados: vêm da tarefa planejada da reunião. Não havendo, o projeto e a categoria são lidos da descrição do evento (mesma convenção Projeto: / Categoria: do pré-mapeamento acima).
• Dispensar: o aviso tem sempre a saída de não iniciar. Reunião dispensada não volta a perguntar.

Backup do banco no Drive

Terceira subseção do card do Google, Backup do banco, identificada pelo logo do Drive. O DeskClock gera um snapshot do banco de dados e o envia para uma pasta visível no seu Drive, chamada DeskClock Backups.

O agendamento é por vencimento, não por horário marcado: passados 24 h, 7 ou 30 dias desde o último sucesso, o backup roda na primeira vez em que você abrir o app. Um backup mensal às 3h da manhã do dia 1 nunca aconteceria; assim, ele acontece.

Os arquivos são nomeados com a data e a hora locais da geração — deskclock-2026-08-12-1430.db — e os mais antigos são podados automaticamente, mantendo os últimos.

Como restaurar

Restaurar é um procedimento manual, de propósito — não há botão para isso.

Tags padrão

Gerenciar apontamentos

O modal de Gerenciar apontamentos exibe as time entries do workspace ativo com filtro por período e por tags padrão. Entradas em andamento são ocultadas. Você pode editar ou excluir registros diretamente do Clockify sem abrir o navegador.

Conectar

Envio de horas

O envio cria um item no grupo Activities do board do projeto. Reenviar atualiza o item em vez de duplicar — o DeskClock rastreia o que já enviou. Se o item foi apagado no Monday, o envio manual o recria.

Funciona nos modos automático (por tarefa ou diário, com botão "Enviar agora") e manual, pelo modal "Enviar tarefas manualmente".

Importar itens como planejadas

O modal "Importar itens como planejadas" traz os itens de trabalho do board — tudo o que está fora do grupo Activities — para o seu planejamento. A data vem da coluna Timeline do item: um dia vira data única, vários viram um período.

Pode rodar sozinho: com a importação automática ligada, o DeskClock relê os boards a cada 4 horas. Item já planejado não é reimportado.

Gerenciar atividades

O modal "Gerenciar atividades" lista, por período, as atividades que você enviou e permite corrigir nome, horas, tipo de cobrança, Activity Type e Project Stage — ou excluir, direto no Monday, sem abrir o navegador.

Configurar OAuth no Zendesk

Importar tickets

Ao terminar, o modal fecha e um aviso confirma quantos tickets foram importados.

Cada ticket importado já vem com uma ação apontando para ele no Zendesk, rotulada como "Zendesk". O menu ⋯ da tarefa abre o ticket com um clique.

O DeskClock não vem com um modelo de IA embutido: você escolhe o provedor e usa a sua própria chave. O card Provedor de IA fica na tela de Integrações. Enquanto nenhum provedor estiver conectado, nada de IA aparece no resto do app.

Conectar

Com o provedor conectado, o card mostra provedor, modelo e URL base, além de "Trocar provedor…". Desconectar apaga a chave e o modelo, mas mantém o provedor e a URL, para reconectar ser só colar a chave de novo.

Cota do provedor

Quando o provedor informa os limites de uso, o card mostra quantas requisições e tokens restam e em quanto tempo renovam, com o texto que o próprio provedor enviou. A medição é da última geração de resumo, e o card diz há quanto tempo ela foi feita. Depois de uma hora, avisa que os números podem já ter renovado. Provedores que não informam limites não mostram esse bloco.

Compact Overlay

• Arrastável — a posição é salva entre sessões.
• Um clique abre o Popup Flyout.
• Com mais de um workspace, a cor do ativo aparece como duas faixas nas bordas do botão. Com um só, não aparece nada.
• O tamanho é fixo. A configuração que existia foi removida.

Popup Flyout

Aparece ao clicar no Compact Overlay — é um painel acoplado, não uma janela separada. Ele fecha com Esc ou ao perder o foco, e por isso não tem botão de fechar.

A anatomia

De cima para baixo, sempre na mesma ordem:

• Cabeçalho: chip do workspace e "Ir para planejamento" à esquerda; "Abrir app" à direita.
• Abas Planejadas / Executadas: existem em todo estado, no mesmo lugar. Iniciar uma tarefa não empurra a lista para baixo.
• Conteúdo da aba: é ele que cede altura quando o rodapé cresce.
• Rodapé: um espaço só, disputado por dois estados — parado, é o botão "Nova tarefa"; em execução, é o card do cronômetro. Nunca os dois.

Aba Planejadas

As tarefas do dia, agrupadas por hora marcada: primeiro as com hora, em ordem de relógio; depois as sem hora. A linha é a mesma do Planejamento: o círculo de concluir à esquerda, o Play à direita, e o menu ⋯ — sempre visível, na primeira coluna da direita, ou pelo clique direito — com Editar, Duplicar, Copiar link e Excluir. O clique na linha abre a edição aqui mesmo, no painel do popup. A tarefa com ações as lista no topo do mesmo menu, e dispará-las não exige iniciar a tarefa.

Concluir direto daqui é útil para a tarefa que você parou como "Pendente" mas que estava de fato terminada — não precisa abrir o planejamento para isso.

Aba Executadas

O que já foi registrado hoje, na mesma linha das outras listas: o Play na ponta direita repete o registro — inicia uma execução nova com estes dados — e o menu ⋯, sempre visível, traz Editar e Excluir (sem confirmação, mas com desfazer). O clique na linha e o clique direito fazem o mesmo que o Editar e o ⋯; com o foco na linha, Enter repete, E edita e Del exclui. Tudo vale para o grupo inteiro: com duas ou mais tarefas iguais, o painel de edição avisa quantas serão atualizadas, e excluir apaga todas. Quando o registro veio de uma planejada com ações, elas abrem o mesmo menu — inclusive depois de a planejada ser concluída.

Nas duas abas, a tarefa em execução se destaca com fundo tingido e um ponto ao lado do nome.

O card da tarefa em execução

Duas linhas, divididas por objeto — em cima a tarefa, embaixo o tempo:

Clicar no nome já abre a edição. Cancelar ficou longe de Parar de propósito: colado nele, o descarte ficava a um pixel da ação que salva.

O popup é estreito, então é nele que o nome mais corta. Quando o nome não cabe, passar o cursor sobre ele mostra o texto inteiro — sem abrir a edição. Vale igual nas duas abas, na tarefa planejada e na já executada.

As ações da tarefa

Quando a tarefa veio de uma planejada com ações configuradas, um raio aparece cavalgando a borda de cima do card. Passe o cursor sobre o card e uma faixa se abre com os chips — um clique em cada abre a URL ou o arquivo.

Editar sem sair do overlay

Três painéis, todos no mesmo desenho: cobrem o popup no tamanho que ele já tem, rolam por dentro e seguram o fechamento no Esc e no blur — Esc fecha o painel, não o popup.

Ao parar

O card troca a linha do cronômetro pelo campo de hora de término e os botões Concluída / Pendente — o mesmo fluxo da tela de Tarefas.

Aviso de reunião

Com o rastreamento de reuniões ligado, o aviso de início e de término aparece nesta mesma janela. Ele surge sem tirar o foco de onde você está digitando, e enquanto ele está aberto o popup não fecha sozinho.

Geral

Conta

Seu nome — usado na saudação da tela de Tarefas.

Comportamento

Duração

Jornada

Meta diária e meta semanal, em horas. É contra elas que os totalizadores da tela de Tarefas mostram o progresso.

Primeiro dia da semana — segunda (padrão) ou domingo. A escolha vale para o app inteiro: o total e a meta semanal, os atalhos "Esta semana", "Semana passada" e "Próxima semana", a vista semanal do Planejamento e a grade dos calendários.

Exibir fim de semana — desligado por padrão. Ligado, sábado e domingo aparecem na semana do Planejamento, entram na importação do Google Agenda e são oferecidos nos dias da recorrência, nos quatro lugares onde ela se edita — tudo isso começando no dia que você escolheu em "Primeiro dia da semana", que enquanto o fim de semana está escondido não tem efeito nenhum. Desligar esconde os dois dias de novo, sem apagar nada: tarefa recorrente marcada em sábado continua salva e volta a aparecer quando você religar. Esta opção existiu até a v2.0.0 e voltou na v2.4.0 — se você a tinha ligado naquela época, vai encontrá-la ligada, porque a preferência nunca foi apagada.

Janelas

Redefinir posições salvas das janelas — devolve a janela principal e os overlays às posições padrão. Útil quando um overlay ficou fora da área visível depois de mudar de monitor.

Overlay

Aparência

A aparência tem dois eixos independentes: a claridade das superfícies e a cor de destaque. As combinações são 2 × 4.

Atalhos globais

Configure atalhos que funcionam mesmo com o app em segundo plano:

API

Liga o servidor HTTP local e define a porta. Com a API ativa, o cartão Conectar ao Claude mostra o comando pronto para ligar o Claude ao DeskClock, com um botão para copiá-lo. Ver API local e Conectar ao Claude.

Atualizações

Mostra a versão instalada e, logo abaixo, as novidades desta versão — as notas da versão que você está usando, separadas em novidades, correções e melhorias. Assim dá para ver o que mudou sem depender de haver uma atualização.

"Verificar atualizações" procura uma versão nova. Havendo, as notas dela aparecem antes do botão "Baixar e instalar", e o download e a instalação acontecem pelo próprio app — sem baixar instalador à mão. Ao terminar, "Reiniciar agora" aplica a atualização.

Navegação

Formulários e listas

São três contratos, e eles valem em todas as telas — não em algumas.

Linhas de tarefa

As listas de tarefa — Planejamento, Entradas de hoje, Histórico, Lançamento manual e o Popup Flyout — respondem às mesmas teclas, com o foco na própria linha. Cada tela só responde ao que ela de fato tem: sem Play não há Enter, e só a planejada duplica e copia link.

Atalhos globais (configuráveis)

Os atalhos globais funcionam mesmo com o DeskClock minimizado ou em segundo plano. Eles são configurados em Configurações → Atalhos globais e mapeados pelo usuário para as combinações de sua preferência.

Navegar para uma tela

Abre o DeskClock e navega diretamente para a tela indicada.

Iniciar uma tarefa

Inicia o timer imediatamente com os parâmetros fornecidos na URL. Todos os campos são opcionais — omitir um parâmetro inicia a tarefa sem aquele dado.

Exemplos

Pré-preencher lançamento manual

Abre a tela de Lançamento manual e preenche o formulário com os dados da URL. Todos os campos são opcionais.

Exemplo

Copiar o link de uma tarefa

Uma tarefa planejada vira um link deskclock://task/share que você manda para outra pessoa — pelo Slack, por exemplo. Quem abre o link vê a tarefa preenchida no próprio DeskClock e decide o que fazer com ela.

Copiar o link

No Planejamento — ou na aba Planejadas do Popup Flyout —, abra o menu ⋯ da tarefa (ou clique nela com o botão direito) e escolha Copiar link; com o foco na linha, a tecla L faz o mesmo. O link vai direto para a área de transferência e um aviso confirma a cópia — não abre nada.

Projeto, categoria e campos personalizados viajam pelo nome, não por um identificador interno: o projeto "Portal" do seu app e o de quem recebe são registros diferentes, e é o nome que os liga. Recorrência e data ficam de fora porque são o jeito de planejar de quem recebe — um link não instala uma repetição no planejamento de outra pessoa. As ações ficam de fora porque carregam endereços e caminhos de arquivo, e um link vindo de fora não deve plantar isso no app de ninguém; se quiser mandar um link junto, mande no corpo da mensagem.

Receber a tarefa

Ao abrir o link, o DeskClock vai para o Planejamento e mostra o modal "Tarefa recebida por link". Nada é gravado até você escolher — e tudo é editável antes:

• Projeto, categoria ou campo que não existe no seu app: o campo fica vazio, com um aviso dizendo o que o link trouxe. Nada é criado por conta própria; cadastrar é decisão sua.
• Data: vem preenchida com hoje.
• Adicionar como planejada: grava a tarefa no Planejamento, na data do campo.
• Iniciar agora: começa o timer na hora. Se houver uma tarefa em execução ou pausada, o modal avisa que ela será encerrada — e o clique encerra, sem segunda confirmação.

Receber link: quando o link não é clicável

O Slack transforma o deskclock:// em link clicável, mas nem todo lugar faz isso — a descrição de um evento do Google Meet, por exemplo, mostra o endereço como texto comum. Para esses casos, use Receber, na barra lateral, entre Integrações e Configurações: cole o endereço no campo e clique em Abrir. O campo aceita qualquer deep link do DeskClock, não só o de tarefa.

Documentação interativa

Com a API ligada, abra http://localhost:27420/docs no navegador. É um Swagger UI completo: a lista de endpoints, os formatos de entrada e saída, e um botão para experimentar cada chamada direto na página. A especificação em JSON fica em /openapi.json.

Endpoints

Controle do timer

Histórico

Totais

Tarefas planejadas

Workspaces

Catálogos

Campos personalizados

Conectar ao Claude (MCP)

A mesma API também fala MCP, o protocolo que assistentes de IA usam para chamar ferramentas. Conectado, o Claude — ou outro cliente MCP — usa o DeskClock a partir de uma conversa em linguagem natural: "inicia uma tarefa de revisão no projeto X", "quanto eu trabalhei nesta semana?". Ele segue as mesmas regras da tela, como a API.

O que ele pode fazer

Alguns pedidos para experimentar:

• "O que está rodando agora?"
• "Inicia 'Revisão de PR' no projeto Portal, categoria Desenvolvimento."
• "Registra uma reunião de ontem das 14h às 15h30 no projeto Interno."
• "Planeja 'Daily' toda segunda a sexta, das 9h às 9h15."
• "Quantas horas faturáveis eu fiz nesta semana?"

API ou deep link?