onecli v2.0.1

O harness de agentes feito para equipes.
Um assistente profissional para empresas. Dê a cada funcionário um agente pessoal seguro e isolado em sandbox.

Website · Docs · Discord

---

Início Rápido

Hospedado na nuvem: onecli.sh

Auto-hospedado

git clone https://github.com/onecli/onecli.git && cd onecli
pnpm install
pnpm run setup

Abra http://localhost:10254

No Kubernetes, instale o Helm chart em vez disso: helm install onecli oci://ghcr.io/onecli/charts/onecli. O guia de auto-hospedagem cobre ambos.

O que é o OneCLI v2?

OneCLI é uma plataforma de código aberto para executar agentes de IA como uma equipe. Você cria um agente por pessoa, concede a cada agente o acesso de que ele precisa, e ele trabalha em um sandbox, roteado por um gateway que injeta as credenciais e aplica sua política.

Por que criamos o OneCLI?

O OneCLI começou como um cofre de credenciais para agentes de IA, construído em Rust. Descobrimos que a maior parte da demanda vinha de indivíduos e equipes executando agentes autônomos como Hermes, OpenClaw e NanoClaw. As pessoas queriam agentes que fizessem trabalho real para quem os executa, mas duas partes estavam faltando:

1. gerenciamento de segredos e permissões.
2. e para equipes - gerenciamento multiplayer.

Todo agente autônomo por aí é feito para uma pessoa. E para uma pessoa, eles são ótimos. No momento em que você precisa replicar isso em uma equipe, fica complicado: criar cada agente, decidir o que cada um pode e não pode fazer, hospedá-los, acompanhar de quem é cada agente.

Então mudamos de rumo e construímos o OneCLI v2.

Feito para equipes

• Seu provedor de identidade, integrado: provisione agentes em nome da identidade de cada funcionário, diretamente do IdP da empresa.
• Um agente por pessoa: todos no workspace recebem seu próprio agente em sandbox, acessível pelo dashboard ou pelo Slack.
• Uma política, aplicada em todos os lugares: gerencie a política da equipe em um só lugar, que será aplicada a qualquer agente nos workspaces.
• Aprovações determinísticas com humano no loop: no próprio chat, para coisas sobre as quais você precisa de 100% de controle, como enviar o e-mail, excluir o ticket do Linear, esvaziar um bucket S3.
• Conexões compartilhadas: conectadas uma vez no nível da equipe, como chaves de LLM ou contas de serviço, concedidas por agente sem nunca serem entregues a um.

O agente

Um agente é algo durável, não um único prompt. Ele tem:

• Um computador: seu próprio sandbox isolado, com um sistema de arquivos e um shell. A única saída é o gateway, então ele pode alcançar o que você concedeu e nada mais.
• Uma conversa: sua própria página no dashboard, ou no Slack. Imagens e arquivos incluídos. Uma mensagem enviada enquanto o agente está trabalhando o redireciona imediatamente em vez de ficar na fila atrás dele.
• Memória: o que o agente aprende é mantido pela plataforma, então nunca é perdido. Você pode lê-la e editá-la a qualquer momento.
• Skills: instruções e auxiliares que você escreve uma vez, sempre disponíveis para o agente.
• Uma agenda: o agente pode planejar trabalho futuro, e a plataforma o desperta no momento certo.
• Credenciais que ele nunca vê: cada agente recebe apenas o acesso que você concedeu, e o gateway o aplica em cada requisição. Ou conecte Bitwarden ou 1Password para injeção sob demanda, sem nada armazenado no servidor.
• Seu próprio app do Slack: conecte-o uma vez e ele responde em canais e DMs com seu próprio nome e avatar, com arquivos e imagens. Exclua o agente e seu app do Slack vai junto.

Os agentes rodam na sua própria infraestrutura. O runner é somente de saída e não possui portas de entrada, então um laptop, um homelab ou uma VPC atrás de NAT funcionam sem ingress e sem túnel.

Arquitetura

• Web Dashboard: aplicação Next.js. Crie agentes, converse com eles, edite a memória e as skills deles, gerencie conexões, secrets e grants.
• API Server: o control plane. É dono do banco de dados, do conversation plane e da fila de trabalho que o runner consulta.
• Rust Gateway: intercepta requisições de saída (incluindo HTTPS, via MITM) e injeta credenciais. Os agentes se autenticam com access tokens por meio de cabeçalhos Proxy-Authorization.
• Runner: inicia, estaciona e recolhe sandboxes de agentes. Somente saída, e nunca toca no banco de dados.
• Sandbox Supervisor: executa dentro de cada sandbox, falando uma interface de harness neutra em relação ao fornecedor, para que o runtime do agente seja intercambiável.
• SSH Terminator: a porta de entrada SSH — termina conexões ssh com certificados de curta duração e as conecta a sandboxes de agentes por meio de um backend de substrate plugável.
• Channel Adapter: o daemon do Slack, um app por agente.
• Secret Store: AES-256-GCM em repouso, descriptografado apenas no momento da requisição, correspondido por padrão de host e caminho, injetado como cabeçalhos ou parâmetros de consulta.

Desenvolvimento Local

git clone https://github.com/onecli/onecli.git && cd onecli
mise install
pnpm install
pnpm dev

É toda a configuração: pnpm dev gera o .env com todos os segredos necessários, inicia o PostgreSQL, aplica as migrações e executa a stack completa. Os pré-requisitos, a referência de comandos, a estrutura do projeto e a configuração estão em docs/development.md.