Puppyone CLI v0.1.0 — 새로운 기능

Puppyone이란?

Puppyone은 멀티 에이전트 협업을 위한 파일 워크스페이스입니다. GitHub와 비슷하지만, 코드 저장소 대신 컨텍스트 — AI 에이전트가 작업에 필요한 문서, 데이터, 설정 파일을 호스팅합니다.

해결하는 문제: 여러분의 정보는 Gmail, Notion, GitHub, Google Drive, 로컬 폴더 등 수십 곳에 흩어져 있습니다. AI 에이전트는 이런 데이터에 쉽게 접근할 수 없습니다. Puppyone이 모든 것을 하나의 워크스페이스로 통합하고, MUT(Managed Unified Tree) — Git과 유사하지만 AI를 위해 설계된 표준 프로토콜을 통해 어떤 에이전트(Claude, GPT, Cursor, 자체 봇)든 읽고 쓸 수 있게 합니다.

Puppyone CLI(puppyone)는 이 모든 것을 터미널에서 관리하는 커맨드라인 도구입니다.

v0.1.0의 변경 사항

세 가지 주요 변경: 터미널에서 원격 파일 시스템 조작, 통합 데이터 연결 명령어, 백그라운드 데몬을 대체하는 간단한 동기화 모델.

1. puppyone data — 터미널에서 클라우드 워크스페이스 조작

이것은: Puppyone은 데이터를 클라우드 파일 시스템(폴더, JSON, Markdown, 파일)에 저장합니다. 이전에는 웹 UI에서만 탐색하고 편집할 수 있었습니다. 이제 터미널에서 모든 것을 할 수 있습니다.

왜 중요한가: Claude Code와 Cursor 같은 AI 코딩 도구는 터미널에서 작동합니다. 스크립트는 터미널에서 실행됩니다. CI/CD 파이프라인도 터미널에서 실행됩니다. 이제 이 모든 것이 Puppyone 워크스페이스를 직접 읽고 쓸 수 있습니다.

puppyone data ls /docs              # 폴더 내용 나열
puppyone data cat /docs/readme.md   # 파일 읽기
puppyone data write /config.json '{"model": "gpt-4"}'  # 생성 또는 업데이트
puppyone data mkdir /new-folder     # 폴더 생성
puppyone data tree /                # 전체 워크스페이스 트리 보기
puppyone data cp /src/a.md /backup/ # 복사
puppyone data mv /old /new          # 이동 또는 이름 변경
puppyone data trash /temp.json      # 소프트 삭제 (복구 가능)
puppyone data restore /temp.json    # 삭제 취소

모든 명령어는 --json을 지원하여 스크립트나 AI 에이전트에 입력으로 사용할 수 있습니다:

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

전체 명령어 목록: ls, cat, tree, stat, write, touch, mkdir, cp, mv, rm, trash, restore.

2. puppyone access — 하나의 명령어로 모든 것을 연결

이것은: Puppyone은 15개 이상의 플랫폼(Gmail, GitHub, Notion, Google Drive 등)에서 데이터를 가져오고, 로컬 폴더와 동기화하고, AI 에이전트를 생성하고, MCP 엔드포인트를 노출하고, 샌드박스를 실행할 수 있습니다. 이 모든 것을 "Access Point(접근점)"라고 부르며, 워크스페이스와 데이터가 오가는 통로입니다.

이전에는 별도의 명령어로 관리했습니다. 이제 puppyone access 하나로 통합되었습니다.

# 데이터 소스 연결
puppyone access add gmail                  # 이메일을 워크스페이스로 가져오기
puppyone access add github --set repo=myorg/myrepo  # GitHub 저장소 동기화
puppyone access add notion                 # Notion 페이지 가져오기

# 로컬 폴더 동기화 (양방향, MUT 프로토콜)
puppyone access add filesystem /code       # 로컬 디렉토리 연결

# AI 에이전트와 엔드포인트 생성
puppyone access add agent "Research Bot"   # AI 에이전트 생성
puppyone access add mcp "My API"           # MCP 엔드포인트 생성
puppyone access add sandbox "Runner"       # 격리된 실행 환경 생성

# 통합 관리
puppyone access ls                         # 모든 연결 한눈에 보기
puppyone access info <id>                  # 접근점 상세 정보
puppyone access pause <id>                 # 동기화 일시 중지
puppyone access resume <id>               # 재개
puppyone access rm <id>                    # 연결 제거

사용 가능한 플랫폼과 설정 방법 확인:

puppyone access providers      # 지원되는 모든 커넥터 나열
puppyone access schema gmail   # Gmail이 받는 설정 필드 확인

3. 백그라운드 데몬 제거

변경 사항: v0.0.2에서 로컬 폴더 동기화는 백그라운드 데몬(상주 프로세스)으로 구현되었습니다. 파일 변경을 감시하고 자동 동기화하는 방식이었지만, 불안정하고 디버그하기 어려웠으며 조용히 크래시되었습니다.

새로운 방식: 파일 시스템 동기화는 MUT 프로토콜을 직접 사용합니다. 파일 시스템 접근점을 생성한 후, 간단하고 명시적인 명령어로 조작합니다:

mut clone <url> --credential <key>    # 초기 설정: 워크스페이스를 로컬에 클론
mut commit -m "updated docs" && mut push  # 로컬 변경 사항을 클라우드에 푸시
mut pull                                   # 클라우드에서 변경 사항 가져오기

백그라운드 프로세스 없음. 불투명한 상태 없음. 준비되면 push, 동기화가 필요하면 pull. Git과 같습니다.

개발자 및 에이전트 빌더를 위한 정보

Puppyone 기반 개발이나 AI 에이전트 워크플로 통합에 참고하세요:

• 모든 명령어 --json 지원 — jq로 파이프, 에이전트에 입력, CI에서 활용
• OAuth 플로우 내장 — puppyone access auth github로 브라우저 기반 OAuth 실행, 수동 토큰 관리 불필요
• 설정 스키마 자기 기술 — puppyone access schema <provider>로 사용 가능한 필드, 타입, 기본값 확인
• 통합 API — 모든 접근점(Gmail, GitHub, 파일 시스템, 에이전트, MCP, 샌드박스)이 동일한 CRUD 명령어 사용: add, ls, info, update, pause, resume, rm

v0.0.2에서 업그레이드

npm install -g puppyone@latest

시작하기

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

더 알아보기: puppyone.ai