Handover

Contexto compartilhado e versionado que humanos e agentes de IA podem revisar e continuar.

Documentação

Handover MCP

Mova trabalho ativo entre Claude Code, Codex, Cursor, Gemini CLI, pessoas e agentes de serviço sem perder decisões, arquivos, histórico ou autoria.

Handover fornece contexto compartilhado e versionado para humanos e agentes de IA por meio de um servidor hospedado do Model Context Protocol, uma CLI sem dependências e oito Agent Skills abertos. Este repositório é a fonte pública, descoberta, instalação e registro de conexão para essas interfaces.

Handover product interface

Pesquisa e evidências

O índice de pesquisa e evidências do Handover reúne o benchmark aberto de continuidade, o relatório de campo de migração do Reporter, o Handoff Continuity Record e a demonstração de continuação executável. As descobertas permanecem ao lado de seus métodos, artefatos de origem, relacionamento de primeira parte e limitações materiais.

O pacote versionado research/v1/ dá a agentes e pesquisadores um índice JSON estável, JSON Schema, metadados de citação e um resumo Markdown limitado. O pacote é uma publicação de primeira parte da Handover e da 44pixels; ele é projetado para inspeção e reutilização, não apresentado como validação independente.

Veja um handoff completo

A demonstração pública de continuação mostra o mesmo fluxo de trabalho de ambos os lados: uma visão humana interativa e um registro legível por agente. Ela inclui Markdown, SQL, JSON, um artefato visual, três revisões atribuíveis, uma nota de revisão humana e a resolução do próximo agente. Nenhuma conta é necessária.

Crie um prompt de handoff privado

O gerador de prompt de handoff de IA transforma trabalho inacabado em prompts separados de captura e recebimento sem exigir uma conta. Os campos do rascunho permanecem dentro da aba do navegador e não são enviados para análises nem armazenados como um rascunho no servidor.

O prompt de recebimento exige que o próximo ator inspecione as evidências, separe estado verificado e não verificado, identifique bloqueadores e declare uma próxima ação limitada antes de continuar. Copie ou baixe o registro Markdown, ou carregue o mesmo rascunho privado em um primeiro handover pré-preenchido.

Mova do Claude Code para o Codex

A importação integrada do Codex é a primeira escolha certa para uma mudança única de configuração, projetos, memórias e conversas recentes suportadas do Claude Code. Use o Handover quando Claude Code e Codex alternarem em trabalho inacabado e precisarem de artefatos compartilhados, identidades separadas, revisão e histórico de revisões.

A receita de transferência de contexto do Claude Code para o Codex contém o checkpoint exato do remetente, a configuração de credencial de serviço de dois hosts, a verificação do receptor, a continuação de concorrência otimista, o teste de revogação e os critérios de aprovação. O guia renderizado explica quando usar a importação nativa e quando usar um handoff durável.

Execute o handoff MCP revisado

A demonstração mostra o registro concluído. O procedimento de handoff MCP de ponta a ponta testa o próprio fluxo de trabalho em identidades autenticadas separadas:

verifique o publicador;
publique Markdown, SQL e JSON;
leia cada artefato de volta;
revise evidências exatas de outra identidade;
publique uma correção com concorrência otimista;
resolva a descoberta contra a revisão corretiva; e
prove que um sucessor novo pode continuar sem a conversa original.

Ele também exercita caminhos negados, somente leitura, revisão obsoleta e credencial revogada. Use o guia renderizado para a justificativa, ou conecte um agente por meio do fluxo de instalação antes de executar o procedimento do repositório.

Use a lista de verificação de handoff de agente de IA

Para um handoff local menor, comece com a lista de verificação Markdown. Ela captura o objetivo, estado atual, decisões, evidências, restrições, próxima ação e propriedade, e então exige que o ator receptor leia a revisão atual, abra as evidências, reproduza um resultado significativo e marque o handoff como aprovado ou bloqueado.

A lista de verificação renderizada e FAQ explica cada etapa de verificação. O modelo bruto funciona sem Handover; use o serviço hospedado quando vários atores precisarem de acesso autenticado, revisões imutáveis, pesquisa, anotações ou propriedade auditável.

Teste a prontidão do contexto de IA da empresa

Antes de conectar o conhecimento da empresa a várias pessoas e agentes, use a lista de verificação de prontidão do contexto de IA da empresa. Ela separa o conhecimento de origem aprovado dos registros de continuação em mudança, inventaria identidades humanas e de serviço, declara limites da empresa e do espaço de trabalho e termina com um piloto de duas pessoas e dois agentes.

O piloto é intencionalmente mais rigoroso do que uma contagem de importação: ele verifica recuperação autorizada, revisões atribuíveis, revisão humana, pesquisas negadas, revogação de agente e continuação em nova sessão. O guia de arquitetura vinculado à fonte explica por que um índice de pesquisa, memória de modelo privada e registros canônicos da empresa têm responsabilidades diferentes.

Use o formato de handoff aberto

O Handoff Continuity Record é um formato JSON neutro de plataforma para o estado que outro humano ou agente de IA precisa para verificar e continuar o trabalho. Ele registra o objetivo, estado verificado e não verificado, decisões, evidências, restrições, próxima ação, propriedade e revisão aberta sem prescrever transporte, roteamento, autenticação ou armazenamento.

O diretório protocol/v1/ contém:

um contrato JSON Schema Draft 2020-12;
um exemplo válido de relatório de inventário;
um verificador de conformidade Node.js sem dependências; e
requisitos de produtor, receptor, escopo e segurança.

node protocol/v1/validate.mjs protocol/v1/example.json

O MCP pode expor as ferramentas usadas para ler e escrever o registro. A2A ou uma estrutura de orquestração pode roteá-lo. Git ou Handover podem armazená-lo.

Conecte-se

O endpoint canônico Streamable HTTP é:

https://handover.sh/api/mcp?profile=core

O perfil principal recomendado expõe 17 ferramentas para fluxos de trabalho diários de identidade, pesquisa, recuperação, revisão, continuação, publicação e portabilidade. Use https://handover.sh/api/mcp?profile=native para todas as 27 operações de primeira parte do Handover. O endpoint não parametrizado https://handover.sh/api/mcp retém todas as 55 ferramentas e aliases do Reporter para integrações existentes.

O endpoint expõe seu handshake MCP e esquemas de ferramentas sem uma conta, para que clientes e diretórios possam verificar a compatibilidade antes de conectar. Chamadas de ferramentas permanecem protegidas e retornam o desafio de recurso OAuth do Handover quando nenhuma credencial humana ou de serviço válida está presente.

Hosts MCP interativos usam o fluxo OAuth de primeira parte do Handover: descoberta padrão, registro dinâmico de cliente, PKCE, tokens de acesso de curta duração e tokens de atualização rotativos. O host abre o Handover em um navegador; entre como você mesmo, revise as permissões solicitadas e aprove a conexão. O Handover registra sua identidade humana em cada ação atribuível.

Executores não assistidos e hosts sem suporte a OAuth usam uma credencial de serviço com escopo, nomeada separadamente, criada em Workspace ou Empresa -> Agentes. Identidades humanas e de serviço permanecem independentemente atribuíveis e revogáveis.

Para a configuração completa, verificação de identidade, teste de continuidade de dois agentes e fluxo de solução de problemas, consulte CONNECTING.md.

Codex

codex mcp add handover --url https://handover.sh/api/mcp?profile=core
codex mcp login handover

Claude Code

claude mcp add --transport http --scope user \
  handover https://handover.sh/api/mcp?profile=core

Gemini CLI

gemini mcp add --transport http --scope user \
  handover https://handover.sh/api/mcp?profile=core

Cursor

Adicione isto a .cursor/mcp.json. O Cursor descobre o servidor de autorização do Handover e solicita o login no navegador quando a conexão inicia:

{
  "mcpServers": {
    "handover": {
      "url": "https://handover.sh/api/mcp?profile=core"
    }
  }
}

Cline

Abra o assistente MCP do Cline:

cline mcp install handover --transport http https://handover.sh/api/mcp?profile=core

Escolha Remoto (HTTP) e Cabeçalhos estáticos, então insira a credencial do agente de serviço com escopo no prompt de cabeçalho privado do Cline. O llms-install.md legível por agente inclui a configuração exata, verificação de identidade, primeira gravação segura, teste de continuação de dois agentes e procedimento de revogação. Use a página de configuração de primeira parte do Cline para o fluxo completo do Handover. Não cole uma credencial real no chat nem confirme as configurações MCP privadas do Cline.

Cliente de linha de comando

A CLI do Handover sem dependências suporta o mesmo fluxo de trabalho durável de um terminal:

npm install --global handover-sh
handover login
handover doctor
handover search "billing migration"
handover pull <slug-or-url> --out ./continued-work
handover publish ./report --title "Weekly report"

A fonte e os metadados do pacote publicado vivem em cli/. O instalador direto auditado permanece disponível quando o npm não é apropriado:

curl -fsSL https://handover.sh/install.sh | sh

As versões do pacote são construídas a partir deste repositório público. O processo de bootstrap e publicação confiável é documentado em RELEASING.md.

handover doctor é uma verificação de conexão somente leitura. Ela verifica o endpoint configurado, identidade resolvida pelo servidor, espaço de trabalho, função, escopos e uma solicitação de contexto protegida sem imprimir a credencial ou alterar um handover. Use a lista de verificação de verificação completa antes da primeira gravação de um agente.

Agent Skills

Instale fluxos de trabalho reutilizáveis do Handover em um agente de codificação compatível com o formato aberto Agent Skills:

npx skills add 44-pixels/handover-mcp --list
npx skills add 44-pixels/handover-mcp --skill handoff
npx skills add 44-pixels/handover-mcp --skill handover-record
npx skills add 44-pixels/handover-mcp --skill handover-publish
npx skills add 44-pixels/handover-mcp --skill handover-test-continuity

A coleção pública inclui um handoff de sessão local-first, habilidades para criar e validar registros legíveis por máquina, verificar conexões, publicar contexto, retomar trabalho, revisar feedback ancorado em revisões, testar continuidade completa de múltiplas identidades e governar o acesso de agentes. Navegue pelo catálogo em skills.handover.sh ou inspecione a fonte em skills/. A coleção também é indexada no diretório Skills.sh. O catálogo organiza as habilidades por fase de handoff, inclui uma solicitação inicial em linguagem simples para cada fluxo de trabalho e expõe as ferramentas MCP exatas e comandos CLI por meio de seu índice legível por máquina.

O runtime é listado independentemente como sh.handover/handover no Registro MCP oficial.

O guia Agent Skills e MCP explica o limite entre instruções de fluxo de trabalho portáteis e capacidades de runtime autenticadas. Seu fluxo de trabalho de ponta a ponta bruto é projetado para recuperação direta por agentes.

Para instalação específica de host, use o guia testado para Claude Code, Codex, Cursor e Gemini CLI. Sua lista de verificação de verificação bruta separa a instalação de arquivos da descoberta de host, ativação de habilidade, identidade MCP autenticada, leitura de volta, acesso negado e continuação entre hosts.

Para publicar um fluxo de trabalho que usa Handover, comece com o kit de desenvolvimento de Agent Skill, o contrato de contribuidor e a habilidade inicial. Copie a habilidade inicial em um novo skills/<name>/SKILL.md; o modelo deliberadamente não usa o nome de arquivo reservado para que os registros não possam confundi-lo com uma habilidade instalável. Envios da comunidade mantêm sua atribuição de publicador e fonte; a inclusão no catálogo não amplia o acesso ao Handover nem substitui a revisão da fonte.

Valide o contrato local antes de testar o fluxo de trabalho autenticado:

node templates/handover-skill/validate.mjs skills/<name>/SKILL.md

Passar neste validador prova o contrato de arquivo, não a descoberta de host, autenticação MCP, permissões, leitura de volta ou comportamento negado. O kit de desenvolvimento mantém essas verificações de runtime explícitas.

Benchmark aberto de continuidade

O Benchmark de Continuidade de Handoff de IA testa se um modelo sucessor consegue recuperar o objetivo, o estado atual, as decisões, as evidências, as restrições, a próxima ação, o responsável e as perguntas em aberto a partir de uma transcrição, memória compactada ou handoff estruturado.

O primeiro piloto com dois sistemas obteve 79,45 em handoffs estruturados, 76,67 em transcrições de conversas e 45,00 em memória compactada. Trata-se de um pequeno piloto autoral, e não de um ranking de modelos. O diretório público benchmark/ contém o conjunto de dados, o gabarito, o avaliador sem dependências, as submissões estritas, os resultados determinísticos, as limitações e todos os 18 corpos de resposta brutos. Reutilize o CITATION.cff, citation.bib ou o summary.csv plano publicados em vez de transcrever valores da página.

cd benchmark/v1
node run.mjs --validate-scorer
node run.mjs --prompts ./prompts

O que os agentes podem fazer

Agentes conectados podem:

verificar a identidade ativa, a organização, o workspace e os escopos com handover.whoami;
pesquisar contexto da empresa ou pessoal;
inspecionar uma revisão imutável exata;
ler arquivos anexados em Markdown, HTML, SQL, JSON, código, imagens e outros formatos;
recuperar discussões e anotações vinculadas a revisões;
criar um novo handover ou continuar um existente;
adicionar, editar, resolver e responder a comentários de revisão;
preservar a identidade autenticada de humano ou serviço no histórico de auditoria.

O servidor nunca pede que um agente forneça uma identidade de autor na entrada da ferramenta. A autoria vem da credencial autenticada.

Verifique a conexão

Peça ao host conectado que execute estas chamadas antes do trabalho real:

Chame handover.whoami sem argumentos e confirme a pessoa retornada ou o agente de serviço nomeado, a organização, o workspace, o papel e os escopos.
Chame handover.search com { "query": "" } e confirme que ele retorna apenas o contexto ao qual essa identidade deve ter acesso.
Leia um handover e um artefato conhecidos antes de criar ou continuar o trabalho.

Uma conexão funcional lista as ferramentas do Handover sem erro de JSON ou de login, preserva a identidade pretendida como autora e para de funcionar imediatamente após a revogação da concessão OAuth ou da credencial de serviço.

Agentes de serviço

Os proprietários de workspace criam agentes de serviço no Handover e concedem apenas os escopos de que esse ator precisa. Armazene a credencial em HANDOVER_TOKEN; não a coloque em um repositório nem em uma configuração MCP versionada no controle de origem.

export HANDOVER_TOKEN='hnd_tok_...'
codex mcp add handover \
  --url https://handover.sh/api/mcp?profile=core \
  --bearer-token-env-var HANDOVER_TOKEN

Descoberta e documentação

Código-fonte e suporte

O código-fonte do aplicativo Handover hospedado é mantido em um repositório privado. Este repositório público contém o registro de conexão MCP, a documentação de configuração e o código-fonte da CLI sem dependências, não a implementação do serviço hospedado.

Relate problemas de conexão ou documentação por meio de GitHub Issues. Relate preocupações de segurança usando o processo descrito em SECURITY.md.