Puppyone CLI v0.1.0 — Novidades

O que é o Puppyone?

Puppyone é um espaço de arquivos para colaboração multi-agente. É como o GitHub, mas em vez de repositórios de código, hospeda contexto — os documentos, dados e arquivos de configuração que agentes de IA precisam para trabalhar.

O problema resolvido: suas informações estão espalhadas entre Gmail, Notion, GitHub, Google Drive, pastas locais e dezenas de outros serviços. Agentes de IA não conseguem acessar tudo isso facilmente. O Puppyone reúne tudo em um workspace unificado e permite que qualquer agente (Claude, GPT, Cursor, seus próprios bots) leia e escreva através de um protocolo padrão chamado MUT (Managed Unified Tree) — como o Git, mas projetado para IA.

O Puppyone CLI (puppyone) é a ferramenta de linha de comando para gerenciar tudo isso pelo terminal.

O que há de novo na v0.1.0?

Três grandes mudanças: sistema de arquivos remoto operável pelo terminal, comando unificado para todas as conexões e modelo de sincronização mais simples substituindo o antigo daemon.

1. puppyone data — Opere seu workspace na nuvem pelo terminal

O que é: O Puppyone armazena seus dados em um sistema de arquivos na nuvem (pastas, JSON, Markdown, arquivos). Antes, só era possível navegar e editar pela interface web. Agora tudo pode ser feito pelo terminal.

Por que importa: Ferramentas de codificação com IA como Claude Code e Cursor funcionam no terminal. Scripts rodam no terminal. Pipelines CI/CD rodam no terminal. Agora todos podem ler e escrever no seu workspace Puppyone diretamente.

puppyone data ls /docs              # listar conteúdo de uma pasta
puppyone data cat /docs/readme.md   # ler um arquivo
puppyone data write /config.json '{"model": "gpt-4"}'  # criar ou atualizar
puppyone data mkdir /new-folder     # criar pasta
puppyone data tree /                # ver a árvore completa do workspace
puppyone data cp /src/a.md /backup/ # copiar
puppyone data mv /old /new          # mover ou renomear
puppyone data trash /temp.json      # exclusão suave (recuperável)
puppyone data restore /temp.json    # desfazer exclusão

Todos os comandos suportam --json para saída estruturada, pronta para scripts ou agentes de IA:

puppyone data ls /docs --json | jq '.entries[].name'

Lista completa de comandos: ls, cat, tree, stat, write, touch, mkdir, cp, mv, rm, trash, restore.

2. puppyone access — Um comando para conectar tudo

O que é: O Puppyone pode buscar dados de mais de 15 plataformas (Gmail, GitHub, Notion, Google Drive, etc.), sincronizar pastas locais, criar agentes de IA, expor endpoints MCP e executar sandboxes. Tudo isso são "Access Points" — as portas pelas quais os dados entram e saem do workspace.

Antes eram gerenciados por comandos separados. Agora tudo está unificado sob puppyone access.

# Conectar fontes de dados
puppyone access add gmail                  # importar emails para o workspace
puppyone access add github --set repo=myorg/myrepo  # sincronizar repositório GitHub
puppyone access add notion                 # importar páginas do Notion

# Sincronizar pasta local (bidirecional, via protocolo MUT)
puppyone access add filesystem /code       # vincular diretório local

# Criar agentes de IA e endpoints
puppyone access add agent "Research Bot"   # criar agente de IA
puppyone access add mcp "My API"           # criar endpoint MCP
puppyone access add sandbox "Runner"       # criar ambiente de execução isolado

# Gerenciamento unificado
puppyone access ls                         # ver todas as conexões
puppyone access info <id>                  # detalhes de um access point
puppyone access pause <id>                 # pausar sincronização
puppyone access resume <id>               # retomar
puppyone access rm <id>                    # remover conexão

Descobrir plataformas disponíveis e configuração:

puppyone access providers      # listar todos os conectores suportados
puppyone access schema gmail   # ver campos de configuração do Gmail

3. Sem mais daemon em segundo plano

O que mudou: Na v0.0.2, a sincronização de pastas locais funcionava com um daemon — um processo persistente que monitorava arquivos e sincronizava automaticamente. Era frágil, difícil de depurar e falhava silenciosamente.

Como funciona agora: A sincronização usa diretamente o protocolo MUT. Após criar um access point de filesystem, você usa comandos simples e explícitos:

mut clone <url> --credential <key>    # configuração inicial: clonar workspace para local
mut commit -m "updated docs" && mut push  # enviar alterações locais para a nuvem
mut pull                                   # obter alterações da nuvem

Sem processos em segundo plano. Sem estados misteriosos. Você faz push quando está pronto, pull quando precisa. Igual ao Git.

Para desenvolvedores e construtores de agentes

Se você está construindo sobre o Puppyone ou integrando-o em workflows de agentes de IA:

• Todos os comandos suportam --json — saída para jq, agentes ou CI
• Fluxos OAuth integrados — puppyone access auth github abre OAuth no navegador, sem gerenciamento manual de tokens
• Introspecção de esquemas de configuração — puppyone access schema <provider> mostra campos disponíveis, tipos e valores padrão
• API unificada — cada access point (Gmail, GitHub, filesystem, agentes, MCP, sandbox) usa os mesmos verbos CRUD: add, ls, info, update, pause, resume, rm

Atualização a partir da v0.0.2

npm install -g puppyone@latest

Primeiros passos

npm install -g puppyone
puppyone auth login
puppyone project use "My Project"
puppyone data ls /

Saiba mais: puppyone.ai