Glossary

Core PuppyOne concepts and terminology.

Data hierarchy

Organization
└── Project
    └── Content Node
        ├── folder
        ├── json
        ├── markdown
        └── file

Core terms

Organization

An organization is the top-level container in PuppyOne. It represents a team or company.

• Manages members and roles, Owner, Admin, and Member
• Manages billing and quotas
• One user can belong to multiple organizations

Project

A project is a data namespace inside an organization, used to isolate data for different business scenarios.

• Each business scenario can have its own project, such as Product Knowledge Base, Support FAQ, or Engineering Docs
• A project contains the Content Node tree, connections, agents, and related resources
• Supports project-level member management and access control

Content Node

Content Nodes are the basic data unit in PuppyOne's cloud file system, organized as a tree.

Each Content Node automatically tracks version history and supports diffing and rollback.

Connection

A connection is PuppyOne's unified abstraction for external integrations. All integration types are managed through the connections table, with provider and direction fields used to distinguish them.

MCP (Model Context Protocol)

MCP is an open protocol introduced by Anthropic that defines how AI models interact with external tools and data sources.

• PuppyOne generates standard MCP interfaces for each agent and MCP endpoint
• Supports direct connections from MCP-compatible clients such as Cursor, Claude Desktop, and Windsurf
• Agents use MCP to call bound tools

FLS (File Level Security)

File-level permissions that precisely control which Content Nodes each agent can access.

• Managed through the connection_accesses table, which binds agents to Content Nodes
• Supports permission levels such as read-only and read/write
• Follows the principle of least privilege

Tool

A tool is a data operation that an agent can call, bound to specific Content Nodes.

Access Key

An access key is a credential used for machine and agent authentication, typically in the form cli_xxx.

• Each agent, MCP endpoint, and sandbox endpoint has its own independent access key
• Keys can be regenerated, and old keys become invalid immediately
• Used for non-interactive authentication in the CLI and API

Sync-related terms

Sync connector

A sync connector pulls data from external SaaS platforms into PuppyOne.

• Supports more than 15 platforms, including Notion, GitHub, Gmail, and Google Drive
• Synced data is transformed into structured JSON or Markdown Content Nodes
• Supports incremental sync, scheduled sync, and manual refresh

OpenClaw

PuppyOne's two-way local folder sync protocol.

• Keeps local directories and the cloud Context File System in real-time sync
• Runs through a background daemon
• CLI commands: puppyone access up and puppyone access down

Collaboration-related terms

Checkout / Commit

A collaborative editing workflow similar to Git.

• Checkout: Check out a working copy of a Content Node and acquire a lock
• Commit: Submit changes and automatically create a new version
• Supports conflict detection

Snapshot

A folder-level backup at a point in time.

• Saves the complete state of a folder at a specific moment
• Supports one-click rollback to any snapshot
• Useful as a safety backup before bulk operations

Audit log

An operation log that records every action performed on Content Nodes.

• Records who, user or agent, did what to which node and when
• Supports filtering by node, time, and actor
• Fully traceable

Distribution methods

MCP server

Provides data access for MCP-compatible clients such as Cursor and Claude Desktop.

REST API

Standard HTTP API for custom agents, backend integrations, and automation scripts.

Publish link

A public short link that lets anyone access JSON data in read-only mode without authentication.

Glossary table