Uma alternativa ao HumanLayer para aprovações de agentes

A versão curta

O HumanLayer começou como um SDK que permitia aos agentes perguntar a uma pessoa antes de agir: require_approval para controlar uma função, human_as_tool para fazer uma pergunta. Hoje o HumanLayer desenvolve uma IDE para agentes de programação, e o SDK de aprovações não recebe uma versão desde junho de 2025. Se você ainda depende dele, o Run it by cobre os mesmos dois padrões, e a pessoa que responde só precisa de um link.

Conferido nas páginas do próprio HumanLayer em novembro de 2026. Não encontramos nenhum aviso oficial de descontinuação, então confirme com o HumanLayer antes de planejar com base na nossa leitura.

O que mudou no HumanLayer

• O humanlayer.dev agora descreve uma IDE multiplayer e uma nuvem para executar o Claude Code, o Codex e outros agentes de programação.
• A última versão do pacote humanlayer no PyPI é a 0.7.9, de junho de 2025.
• A documentação de aprovações não está mais no site, e o repositório agora abriga o novo produto.

É uma decisão sensata para o HumanLayer, e se você supervisiona agentes de programação em equipe, o novo produto foi feito para isso. Só deixa os agentes que precisam do aval de uma pessoa sem o SDK que usavam.

Os mesmos padrões no Run it by

• Controlar uma ação (require_approval): crie uma solicitação com mode: "approval", o motivo e as pessoas que decidem. Aja somente quando o veredito for approved.
• Fazer uma pergunta (human_as_tool): crie uma solicitação com mode: "form" e um JSON Schema para a resposta. Ela volta validada contra esse esquema.
• Receber a resposta: um webhook assinado, getStatus com uma espera de até 25 segundos ou, por MCP no Builder e no Pro, uma notificação no momento em que alguém responde.

Exemplo

Um pequeno require_approval em Python sobre a API REST. Ele espera dentro da chamada; em produção, prefira o webhook.

import os, requests

API = "https://runitby.app/v1/requests"
AUTH = {"Authorization": f"Bearer {os.environ['RUNITBY_API_KEY']}"}

def require_approval(reason, approvers):
    request = requests.post(API, headers=AUTH, json={
        "mode": "approval",
        "title": reason,
        "requester": "The billing agent",
        "audience": {"kind": "named", "recipients": approvers},
        "approval": {"reason": reason, "policy": "any", "verify": "email"},
        "expiresIn": "24h",
        "sendEmail": True,
    }).json()
    while True:
        status = requests.get(
            f"{API}/{request['requestId']}?wait=25", headers=AUTH
        ).json()
        if status["verdict"]:
            return status["verdict"] == "approved"

if require_approval("Refund order #4821, $1,200",
                    [{"name": "Emily Lee", "email": "emily@acme.com"}]):
    issue_refund("4821")

declined e expired retornam False, então o silêncio nunca vira um reembolso.

O que é diferente

• Quem aprova não precisa de Slack nem de conta. Cada pessoa nomeada recebe o próprio link por e-mail, ou você repassa o link, inclusive pelo Slack.
• Vários aprovadores com uma regra (qualquer um, todos, maioria ou um número), um código por e-mail opcional para cada pessoa e uma expiração que termina como expired.
• Não há um decorator para envolver suas funções; você chama a API ou as ferramentas do MCP. Se você dependia de aprovações que chegavam como mensagens do Slack com botões, o Run it by não faz isso.

Para uma visão mais ampla das opções, veja Run it by vs ferramentas de aprovação.