# paperclip | Paperclip | Knowledge Base | Instagit The open-source app everyone uses to manage agents at work GitHub Stars: 77.2k Repository: https://github.com/paperclipai/paperclip --- ## Articles ### [How OpenTelemetry Tracing Is Configured in Paperclip and Which Spans Are Auto-Instrumented](/paperclipai/paperclip/paperclip-opentelemetry-tracing-configuration) Configure OpenTelemetry tracing in Paperclip for HTTP, PostgreSQL, and custom spans. Discover which spans are auto-instrumented to enhance observability. - Tags: internals - Published: 2026-08-18 ### [How to Disable Telemetry Collection in Paperclip and What Data Is Collected](/paperclipai/paperclip/disable-paperclip-telemetry-collection) Disable Paperclip telemetry collection by setting telemetry.enabled false in paperclip.yaml. Learn what data is collected and protect your privacy. - Tags: how-to-guide - Published: 2026-08-18 ### [How Paperclip Handles Secret Scrubbing and Collision During Company Import and Export](/paperclipai/paperclip/paperclip-company-import-export-secrets-collisions) Learn how Paperclip's import export handles secret scrubbing and collision using its manifest-based architecture to secure your data and prevent overwrites. - Tags: how-to-guide - Published: 2026-08-18 ### [How to Create a Custom Agent Adapter for a New Runtime or CLI Tool in Paperclip](/paperclipai/paperclip/create-custom-paperclip-agent-adapter) Learn how to create a custom agent adapter in Paperclip for new runtimes or CLI tools by registering adapter types, implementing session codecs, and wiring the execute function into the server. - Tags: how-to-guide - Published: 2026-08-18 ### [Execution Semantics for Task Recovery and Watchdog Verification in Paperclip](/paperclipai/paperclip/paperclip-execution-semantics-task-recovery-watchdog) Discover Paperclip's task recovery and watchdog verification. Learn about its two-phase execution model, fingerprint-based change detection, and safety checks for robust agent management. - Tags: internals - Published: 2026-08-18 ### [How Scheduled Routines with Cron Triggers Wake Paperclip Agents and Create Tracked Issues](/paperclipai/paperclip/paperclip-scheduled-routines-cron-triggers) Learn how Paperclip uses cron triggers and its scheduler loop to wake agents and create tracked issues for automated workflows. Discover efficient scheduled automation. - Tags: how-to-guide - Published: 2026-08-18 ### [How Paperclip Tracks Costs by Aggregating Token Usage: A Deep Dive into the ACP Pipeline](/paperclipai/paperclip/paperclip-cost-tracking-token-usage) Discover how Paperclip tracks costs by aggregating token usage at the AI agent runtime. Learn about its ACP pipeline for cost tracking, dashboards, and billing. - Tags: deep-dive - Published: 2026-08-18 ### [How to Integrate MCP Servers with the Paperclip Tool Gateway and Access Governance](/paperclipai/paperclip/integrate-mcp-servers-paperclip-tool-gateway) Securely integrate MCP servers with Paperclip's Tool Gateway. Enforce access controls, use token authentication, and leverage audit logging for robust access governance. - Tags: how-to-guide - Published: 2026-08-18 ### [Paperclip Deployment Modes Explained: `local_trusted`, `authenticated`, and `private/public` Configuration](/paperclipai/paperclip/paperclip-deployment-modes-usage) Understand Paperclip deployment modes local_trusted, authenticated, and private/public. Choose the right security for your project from solo dev to public SaaS. - Tags: deep-dive - Published: 2026-08-18 ### [How Paperclip Propagates Goal Hierarchy Context to Agents](/paperclipai/paperclip/paperclip-goal-hierarchy-context-propagation) Discover how Paperclip propagates goal hierarchy context to agents via a scoped ctx.goals service and RPC host injection. Learn about parent-child relationships. - Tags: internals - Published: 2026-08-18 ### [How to Configure Paperclip Secrets Management with Scoped Access per Agent](/paperclipai/paperclip/configure-paperclip-secrets-management-scoped-access) Secure your Paperclip secrets with scoped access per agent. Learn how to configure explicit bindings for enhanced security and control over your sensitive data. - Tags: how-to-guide - Published: 2026-08-18 ### [How Paperclip Org-Chart Hierarchy Uses `reportsTo` and Role Permissions](/paperclipai/paperclip/paperclip-org-chart-hierarchy-permissions) Understand the Paperclip org chart hierarchy using reportsTo and role permissions. Discover how Paperclip manages reporting relationships and fallback authority. - Tags: how-to-guide - Published: 2026-08-18 ### [How Paperclip Execution Workspaces Manage Project Directories, Git Worktrees, and Runtime Services](/paperclipai/paperclip/paperclip-execution-workspaces-project-git-services) Learn how Paperclip execution workspaces streamline project directories, Git worktrees, and runtime services for efficient agent runs. Discover isolated, reproducible snapshots and coordinated services. - Tags: internals - Published: 2026-08-18 ### [Understanding the Structure of the Paperclip Activity Log for Audit Trails and Action Attribution](/paperclipai/paperclip/paperclip-activity-log-structure-audit-trails) Explore the Paperclip activity log structure. Learn how its relational table, actor attribution, and JSONB metadata create tamper-evident audit trails for secure action attribution. - Tags: internals - Published: 2026-08-18 ### [How to Develop and Install Plugins Using the Paperclip Local Plugin Runtime](/paperclipai/paperclip/develop-install-paperclip-plugins-local-runtime) Learn to develop and install plugins with the Paperclip local plugin runtime. Use the plugin SDK and CLI commands to author and execute plugins locally without cloud deployment. - Tags: how-to-guide - Published: 2026-08-18 ### [How Paperclip Enforces Multi‑Company Data Isolation at the Database and API Level](/paperclipai/paperclip/paperclip-multi-company-data-isolation) Learn how Paperclip enforces multi-company data isolation using database foreign keys, scoped queries, runtime validation, and strict API checks. Secure your SaaS data. - Tags: architecture - Published: 2026-08-18 ### [How Paperclip Board Approval Workflows and Governance Gates Function for Agent Hires](/paperclipai/paperclip/paperclip-board-approval-governance-gates) Learn how Paperclip board approval workflows and governance gates ensure policy checks, budget compliance, and explicit board approval for every agent hire before activation. - Tags: how-to-guide - Published: 2026-08-18 ### [What Is Atomic Task Checkout in Paperclip and How Execution Locks Prevent Double-Work](/paperclipai/paperclip/paperclip-atomic-task-checkout-execution-lock) Learn about Paperclip's atomic task checkout and execution locks. Discover how this database locking mechanism prevents duplicate work by ensuring only one agent claims and works on an issue at a time. - Tags: deep-dive - Published: 2026-08-18 ### [How Paperclip Enforces Budgets with Hard-Stop Auto-Pause at Agent and Company Levels](/paperclipai/paperclip/paperclip-budget-enforcement-auto-pause) Discover how Paperclip enforces budgets with hard-stop auto-pause. Learn about its three-layer system that automatically pauses workflows when spending exceeds limits at agent and company levels. - Tags: deep-dive - Published: 2026-08-18 ### [Paperclip Heartbeat System Configuration Options: Complete Guide](/paperclipai/paperclip/paperclip-heartbeat-configuration-options) Explore Paperclip heartbeat system configuration options. Learn to enable the scheduler, set intervals, control concurrency, and track runtime state for agents and UI. - Tags: how-to-guide - Published: 2026-08-18 ### [How the Paperclip Heartbeat System Triggers Agent Execution: A Deep Architectural Guide](/paperclipai/paperclip/how-does-paperclip-heartbeat-trigger-agent-execution) Understand how the Paperclip heartbeat system triggers agent execution. Learn about its three-phase pipeline: wakeup requests, queue processing, and agent launching. - Tags: deep-dive - Published: 2026-08-18 ### [How Paperclip’s Telemetry System Works and How to Disable It](/paperclipai/paperclip/what-is-telemetry-system-and-how-can-it-be-disabled) Understand Paperclip's telemetry system and learn how to disable it by setting the PAPERCLIP_TELEMETRY_ENABLED environment variable to false. Take control of your data. - Tags: internals - Published: 2026-08-16 ### [How Work Products and Artifacts Are Stored and Managed in Paperclip](/paperclipai/paperclip/how-are-work-products-and-artifacts-stored-and-managed) Discover how Paperclip stores and manages work products and artifacts in PostgreSQL. Access everything via a robust REST API for efficient data handling. - Tags: internals - Published: 2026-08-16 ### [How to Set Up Paperclip for Local Development with Embedded PGlite](/paperclipai/paperclip/what-is-development-setup-with-embedded-pglite-for-local-testing) Set up Paperclip for local development with embedded PGlite. Run Paperclip locally without an external database for seamless testing. Learn the simple development setup. - Tags: how-to-guide - Published: 2026-08-16 ### [How the OpenClaw Gateway Integration Connects External Agents to Paperclip: A Complete Technical Guide](/paperclipai/paperclip/how-does-openclaw-gateway-integration-connect-external-agents) Learn how the OpenClaw gateway integration securely connects external agents to Paperclip using WebSockets, tokens, and standardized join requests. Explore the technical guide for Paperclip AI. - Tags: how-to-guide - Published: 2026-08-16 ### [How Agent API Keys Work with Hash-Based Storage and Company Boundaries in Paperclip](/paperclipai/paperclip/how-do-agent-api-keys-work-with-hash-based-storage-and-company-boundaries) Discover how Paperclip's agent API keys use SHA-256 hashing for secure storage and automatically enforce company boundaries with `companyId` scoping. Learn more now. - Tags: internals - Published: 2026-08-16 ### [Goals Hierarchy and Goal-to-Task Linking Data Model in Paperclip](/paperclipai/paperclip/what-is-data-model-for-goals-hierarchy-and-goal-to-task-linking) Understand the Paperclip data model for goals hierarchy and goal-to-task linking. Explore how Paperclip uses a self-referencing table and join tables for flexible goal management. - Tags: internals - Published: 2026-08-16 ### [How Paperclip Task Watchdog Recovery Handles Execution Failures: A Deep Dive](/paperclipai/paperclip/how-does-task-watchdog-recovery-handle-execution-failures) Learn how Paperclip task watchdog recovery handles execution failures by detecting stopped subtrees, creating fingerprints, and resuming failed tasks automatically. - Tags: deep-dive - Published: 2026-08-16 ### [Paperclip Agent API Contract: Heartbeat Reporting and Task Operations Explained](/paperclipai/paperclip/what-is-agent-api-contract-for-heartbeat-reporting-and-task-operations) Explore the Paperclip agent API contract for heartbeat reporting and task operations. Understand REST endpoints, TypeScript interfaces, and OpenAPI specs for managing agent status and tasks. - Tags: api-reference - Published: 2026-08-16 ### [How Routines and Scheduled Tasks Work in Paperclip: Cron and Triggers Explained](/paperclipai/paperclip/how-are-routines-and-scheduled-tasks-implemented-with-cron-and-triggers) Discover how Paperclip uses cron and triggers for scheduled automation. Learn about its custom JavaScript scheduler for efficient routine execution. - Tags: internals - Published: 2026-08-16 ### [Paperclip Company Portability Workflow: Import/Export with Secret Scrubbing](/paperclipai/paperclip/what-is-company-portability-workflow-for-import-export-with-secret-scrubbing) Securely migrate your entire company data with Paperclip's import/export workflow. Effortlessly transfer agents, projects, tasks, and skills while automatically stripping secrets. - Tags: how-to-guide - Published: 2026-08-16 ### [How Paperclip Tracks and Aggregates Cost Events Across Agents, Tasks, and Projects](/paperclipai/paperclip/how-are-cost-events-tracked-and-aggregated-across-agents-tasks-and-projects) Discover how Paperclip tracks and aggregates cost events across agents, tasks, and projects. Learn about centralized LLM billing records and data aggregation. - Tags: architecture - Published: 2026-08-16 ### [How to Configure Paperclip Deployment Modes: Trusted Local vs Authenticated](/paperclipai/paperclip/how-to-configure-different-deployment-modes-trusted-local-vs-authenticated) Learn to configure Paperclip deployment modes. Choose trusted local for solo dev or authenticated for teams. Set PAPERCLIP_DEPLOYMENT_MODE and PAPERCLIP_DEPLOYMENT_EXPOSURE for secure deployments. - Tags: how-to-guide - Published: 2026-08-16 ### [How Paperclip Isolates Agent Execution with Workspaces and Runtime Sandboxes](/paperclipai/paperclip/how-does-workspace-and-runtime-isolation-system-work-for-agent-execution) Discover how Paperclip isolates agent execution using worktrees and sandboxed runtimes. Learn about their resource provisioning and teardown for secure agent workflows. - Tags: internals - Published: 2026-08-16 ### [Agent Approval and Governance Workflow in Paperclip: A Complete Technical Guide](/paperclipai/paperclip/what-is-workflow-for-agent-approval-and-governance) Explore Paperclip's agent approval and governance workflow. Learn how explicit board approvals and immutable audit trails ensure secure agent management. A complete technical guide. - Tags: deep-dive - Published: 2026-08-16 ### [How Paperclip Manages Secrets and Injects Them Into Agent Execution Contexts](/paperclipai/paperclip/how-are-secrets-managed-and-injected-into-agent-execution-contexts) Discover how Paperclip securely manages and injects secrets into agent execution contexts. Learn about encrypted storage, pluggable providers, and automatic log redaction for enhanced security. - Tags: how-to-guide - Published: 2026-08-16 ### [How the Org Chart Tree Structure Works with Reporting Relationships in Paperclip](/paperclipai/paperclip/how-does-org-chart-tree-structure-work-with-reporting-relationships) Understand how Paperclip's org chart tree structure uses reports_to for reporting relationships. Learn about DAGs, cycle prevention, and depth violations for reliable task delegation. - Tags: deep-dive - Published: 2026-08-16 ### [Paperclip Plugin Architecture: How to Build Custom Plugins for Paperclip](/paperclipai/paperclip/what-is-plugin-architecture-and-how-to-extend-paperclip-with-custom-plugins) Learn Paperclip's plugin architecture and build custom plugins. Understand the manifest, worker process, and UI bundle to extend Paperclip's capabilities. - Tags: how-to-guide - Published: 2026-08-16 ### [How Budget Enforcement Works with Hard-Stop Auto-Pause Behavior in Paperclip](/paperclipai/paperclip/how-budget-enforcement-works-with-hard-stop-auto-pause-behavior) Learn how Paperclip's budget enforcement with hard-stop auto-pause halts agents and projects on spending breaches. Ensure controlled spending and resume work with manual approval. - Tags: how-to-guide - Published: 2026-08-16 ### [How Paperclip Enforces Company-Scoped Data Isolation and Multi-Tenancy](/paperclipai/paperclip/what-is-paperclips-company-scoped-data-isolation-model-and-how-is-multi-tenancy-enforced) Discover how Paperclip enforces company-scoped data isolation and multi-tenancy using a `company_id` foreign-key for robust security across all layers. - Tags: architecture - Published: 2026-08-16 ### [How Atomic Task Checkout Prevents Double-Work in Distributed Agent Execution](/paperclipai/paperclip/how-atomic-task-checkout-prevents-double-work-in-distributed-agent-execution) Discover how atomic task checkout prevents double-work in distributed agent execution. Learn about the single-writer lock ensuring only one agent claims an issue, avoiding conflicts. - Tags: internals - Published: 2026-08-16 ### [Paperclip Agent Adapters: Complete Guide to Built-in and Custom Configuration](/paperclipai/paperclip/what-agent-adapters-are-supported-and-how-to-configure-custom-adapters) Discover Paperclip Agent Adapters. Explore 11 built-in options like Claude Code and Gemini, and learn to easily configure custom adapters via npm or local directories. - Tags: how-to-guide - Published: 2026-08-16 ### [How Paperclip's Heartbeat System Triggers and Manages Agent Execution](/paperclipai/paperclip/how-paperclips-heartbeat-system-triggers-and-manages-agent-execution) Discover how Paperclip's heartbeat system triggers agent execution via its wakeup API, scheduling checks, and a multi-stage pipeline for seamless workflow management. - Tags: internals - Published: 2026-08-16 ### [How Paperclip Handles Authentication for Deployments: A Complete Technical Guide](/paperclipai/paperclip/how-paperclip-handle-authentication-deployments) Discover how Paperclip handles authentication for deployments. Explore its deployment-mode driven system, supporting local trusted and authenticated production modes with robust access controls. - Tags: how-to-guide - Published: 2026-08-14 ### [What Is `pnpm dev` in Paperclip? A Deep Dive Into the Local Development Runtime](/paperclipai/paperclip/purpose-pnpm-dev-paperclip-development) Discover how pnpm dev in Paperclip AI powers your local development. This command starts the API, UI, manages databases, and restarts automatically. - Tags: deep-dive - Published: 2026-08-14 ### [How to Run Database Migrations in Paperclip Development](/paperclipai/paperclip/how-run-database-migrations-paperclip-development) Learn to run database migrations in Paperclip development. Automate with dev server start or use pnpm db:migrate for local Docker or hosted PostgreSQL. - Tags: how-to-guide - Published: 2026-08-14 ### [Where to Find the Main Server Entry Point in the Paperclip Repository](/paperclipai/paperclip/where-find-main-server-entry-point-paperclip) Locate the main server entry point for Paperclip at server/src/index.ts. This file bootstraps the environment, creates the Express app, and starts the listener. - Tags: internals - Published: 2026-08-14 ### [Paperclip AI Onboard Command Configuration Options: Complete CLI and Environment Guide](/paperclipai/paperclip/configuration-options-paperclipai-onboard-command) Master paperclipai onboard command configuration with our complete CLI and environment variable guide. Discover all six flags and 20+ env vars for database, auth, and server settings. - Tags: api-reference - Published: 2026-08-14 ### [How to Use the Paperclip CLI for Onboarding: Complete Setup Guide](/paperclipai/paperclip/how-use-paperclip-cli-onboarding) Master the Paperclip CLI for seamless onboarding. Generate configs, run health checks, and launch your server with a single command. Get your Paperclip setup guide now. - Tags: how-to-guide - Published: 2026-08-14 ### [What Data Is Included When Exporting a Paperclip Organization: Complete 2024 Guide](/paperclipai/paperclip/data-included-exporting-paperclip-organization) Export your Paperclip organization to a portable Agent Company bundle. Learn what declarative data is included, from agents and projects to logs and monitors, for full fidelity restoration. - Tags: getting-started - Published: 2026-08-14 ### [How to Export and Import Company Configurations in Paperclip: Complete Guide](/paperclipai/paperclip/how-export-import-company-configurations-paperclip) Learn to export and import company configurations in Paperclip using REST APIs or CLI. Seamlessly transfer branding, agents, org charts, and more with this complete guide. - Tags: how-to-guide - Published: 2026-08-14 ### [What Capabilities Can Plugins Expose to Paperclip Agents: A Complete Guide](/paperclipai/paperclip/capabilities-plugins-expose-paperclip-agents) Explore the seven core capability categories plugins expose to Paperclip agents: tools, authentication, UI, events, jobs, state, and hooks. Unlock the full potential of your agents. - Tags: how-to-guide - Published: 2026-08-14 ### [How to Extend Paperclip Using the Plugin System: A Complete Developer Guide](/paperclipai/paperclip/how-extend-paperclip-using-plugin-system) Extend Paperclip using its plugin system. Learn to create manifests and implement workers with definePlugin to integrate custom capabilities and enhance your AI workflows. - Tags: how-to-guide - Published: 2026-08-14 ### [How Paperclip Integrates with Git for Worktree Execution](/paperclipai/paperclip/how-paperclip-integrate-git-worktree-execution) Discover how Paperclip integrates with Git for worktree execution. Learn how it isolates agent runs in temporary checkouts for code isolation, deterministic execution, and safe cleanup. - Tags: how-to-guide - Published: 2026-08-14 ### [What Are Paperclip's Execution Workspaces? A Complete Technical Guide](/paperclipai/paperclip/what-paperclip-execution-workspaces) Explore Paperclip's execution workspaces, dedicated filesystem checkouts for runs and issues. Learn about Git worktrees and cloud-managed alternatives in this technical guide. - Tags: deep-dive - Published: 2026-08-14 ### [How Paperclip Tracks Costs for Agents and Tasks: A Complete Technical Guide](/paperclipai/paperclip/how-paperclip-track-costs-agents-tasks) Discover how Paperclip tracks agent and task costs by recording token usage and expenses. Learn about real-time spend aggregation, budget enforcement, and reporting APIs. - Tags: how-to-guide - Published: 2026-08-14 ### [Paperclip Budget Control Features: A Complete Guide to Spend Management and Enforcement](/paperclipai/paperclip/budget-control-features-paperclip) Master spend management with Paperclip's budget control features. Discover automatic enforcement, alerts, pausing, and approval workflows for effective resource allocation. Read the complete guide. - Tags: deep-dive - Published: 2026-08-14 ### [How Paperclip Manages Agent Governance and Approvals: A Complete Guide to MCP Access Control](/paperclipai/paperclip/how-paperclip-manage-agent-governance-approvals) Discover how Paperclip enforces agent governance and approvals with its four-layer MCP Access Governance stack. Learn how to manage tool call approvals effectively. - Tags: how-to-guide - Published: 2026-08-14 ### [Complete Guide to Task Statuses in Paperclip: All 21 States Explained](/paperclipai/paperclip/task-statuses-paperclip) Explore all 21 Paperclip task statuses, from creation to archival. Understand the full task lifecycle and ensure smooth workflow management with this comprehensive guide. - Tags: deep-dive - Published: 2026-08-14 ### [Paperclip Agent Adapter Interface: The ServerAdapterModule Contract Explained](/paperclipai/paperclip/standard-interface-paperclip-agent-adapters) Understand the ServerAdapterModule contract, the standard interface for Paperclip agent adapters. Learn how to build custom adapters for your projects. - Tags: api-reference - Published: 2026-08-14 ### [What Is the `packages/shared` Directory in Paperclip? A Complete Guide to Shared Types, Constants, and Validators](/paperclipai/paperclip/purpose-packages-shared-directory-paperclip) Explore the purpose of the packages shared directory in Paperclip. Discover how it unifies types, constants, and validators across your backend, CLI, UI, and adapters for efficient development. - Tags: deep-dive - Published: 2026-08-14 ### [How Paperclip Handles Database Interactions: A Deep Dive into Drizzle ORM, Postgres.js, and Embedded Postgres](/paperclipai/paperclip/how-paperclip-handle-database-interactions) Discover how Paperclip manages database interactions using Drizzle ORM and postgres.js. Learn about its support for external Postgres and embedded PGLite, typed clients, and migrations. - Tags: deep-dive - Published: 2026-08-14 ### [What Technologies Are Used in the Paperclip Backend? A Complete Stack Breakdown](/paperclipai/paperclip/what-technologies-used-paperclip-backend) Discover the Paperclip backend technologies including Node.js, TypeScript, Express, Drizzle ORM, and Vite. Get a complete stack breakdown for this AI project. - Tags: deep-dive - Published: 2026-08-14 ### [How to Deploy Paperclip AI to Production with an External PostgreSQL Database](/paperclipai/paperclip/production-deployment-paperclip-ai-external-postgres) Deploy Paperclip AI to production with an external PostgreSQL database. Set DATABASE_URL and enable authenticated mode for a seamless setup. Get your AI running efficiently. - Tags: how-to-guide - Published: 2026-08-12 ### [Paperclip AI Task Inbox Classification and Archive System: Complete Technical Guide](/paperclipai/paperclip/paperclip-ai-task-inbox-classification-archive-system) Master the Paperclip AI task inbox classification and archive system. Learn how it ingests, classifies, assigns tasks, and archives runs with audit trails. Get the complete technical guide. - Tags: deep-dive - Published: 2026-08-12 ### [Paperclip AI Agent Work Verification with Diffs and Screenshots: A Deep Source‑Code Analysis](/paperclipai/paperclip/paperclip-ai-agent-work-verification-diffs-screenshots) Verify Paperclip AI agent work with diffs and screenshots. See code changes and UI artifacts side-by-side for deep source-code analysis. Enhance your AI agent development. - Tags: deep-dive - Published: 2026-08-12 ### [How to Disable Telemetry in Paperclip AI: 3 Methods for Complete Privacy](/paperclipai/paperclip/how-disable-telemetry-paperclip-ai) Disable Paperclip AI telemetry for complete privacy. Learn 3 effective methods to stop usage tracking and ensure your data stays secure. Explore now. - Tags: how-to-guide - Published: 2026-08-12 ### [Paperclip AI OpenTelemetry Integration and Tracing Configuration: Complete Guide](/paperclipai/paperclip/paperclip-ai-opentelemetry-integration-tracing-configuration) Integrate Paperclip AI with OpenTelemetry for distributed tracing. Learn how to configure tracing for your control plane by setting OTEL_EXPORTER_OTLP_ENDPOINT. - Tags: how-to-guide - Published: 2026-08-12 ### [Tracking and Storing Work Products and Artifacts in Paperclip AI: A Complete Guide](/paperclipai/paperclip/tracking-storing-work-products-artifacts-paperclip-ai) Learn to track and store work products and artifacts in Paperclip AI. Discover how Paperclip AI manages metadata in PostgreSQL and raw files in object storage with a unified API for seamless artifact management. - Tags: how-to-guide - Published: 2026-08-12 ### [Execution Semantics for Issue Dependencies and Blockers in Paperclip AI](/paperclipai/paperclip/execution-semantics-issue-dependencies-blockers-paperclip-ai) Understand execution semantics for issue dependencies and blockers in Paperclip AI. Explore directed-acyclic graphs, hard execution constraints, topological ordering, and actionable items for stalled blockers. - Tags: internals - Published: 2026-08-12 ### [Paperclip AI Heartbeat Queue Coalescing and Orphan Run Recovery: A Technical Deep Dive](/paperclipai/paperclip/paperclip-ai-heartbeat-queue-coalescing-orphan-run-recovery) Explore Paperclip AI heartbeat queue coalescing and orphan run recovery. Discover how policy-driven coalescing and proactive orphan detection ensure reliable agent execution after crashes. - Tags: deep-dive - Published: 2026-08-12 ### [Company Import/Export with Secret Scrubbing in Paperclip AI: The Complete Technical Guide](/paperclipai/paperclip/company-import-export-secret-scrubbing-paperclip-ai) Learn company import export with secret scrubbing in Paperclip AI. Effortlessly move your organization data securely, removing sensitive secrets like API keys. - Tags: how-to-guide - Published: 2026-08-12 ### [Paperclip AI Org Chart: Roles, Permissions, and Reporting Lines Explained](/paperclipai/paperclip/paperclip-ai-org-chart-roles-permissions-reporting-lines) Understand Paperclip AI org chart roles, permissions, and reporting lines. Explore agent hierarchy, role tags for styling, and separate access control for enhanced security. - Tags: how-to-guide - Published: 2026-08-12 ### [MCP Server Integration and Tool Exposure to Agents in Paperclip AI: Implementation Guide](/paperclipai/paperclip/mcp-server-integration-tool-exposure-agents-paperclip-ai) Integrate MCP servers with Paperclip AI agents. Our secure Tool Gateway exposes JSON-RPC 2.0 endpoints for session management and tool discovery. Learn more! - Tags: how-to-guide - Published: 2026-08-12 ### [Paperclip AI Routines with Cron Triggers and Catch-Up Policies: Complete Technical Guide](/paperclipai/paperclip/paperclip-ai-routines-cron-triggers-catch-up-policies) Master Paperclip AI routines with cron triggers and catch-up policies. Ensure reliable agent execution across time zones and replay missed runs after downtime. Technical guide. - Tags: how-to-guide - Published: 2026-08-12 ### [Paperclip AI Activity Logging and Mutation Tracking: Complete Architecture Guide](/paperclipai/paperclip/paperclip-ai-activity-logging-mutation-tracking) Learn how Paperclip AI logs every data mutation as an immutable activity event. Understand its complete architecture for tracking user activity across database, API, UI, and CLI layers. - Tags: architecture - Published: 2026-08-12 ### [How Paperclip AI Loads Skills and Injects Them into Agent Contexts](/paperclipai/paperclip/how-skills-loaded-injected-agent-contexts-paperclip-ai) Learn how Paperclip AI loads skills from its catalog, injects them as JSON metadata into agent prompts, and mounts source files into the execution sandbox for efficient agent context. - Tags: internals - Published: 2026-08-12 ### [Paperclip AI Plugin Architecture and Out-of-Process Worker Communication: A Complete Guide](/paperclipai/paperclip/paperclip-ai-plugin-architecture-out-of-process-worker-communication) Explore the Paperclip AI plugin architecture and out-of-process worker communication. Learn how JSON-RPC 2.0 and stdin/stdout ensure secure, isolated, and high-performance messaging. - Tags: architecture - Published: 2026-08-12 ### [Enforcing Approval Gates with Paperclip AI Governance System](/paperclipai/paperclip/enforcing-approval-gates-paperclip-ai-governance-system) Enforce approval gates with Paperclip AI governance. Ensure human-in-the-loop approval for high-risk operations, create formal records, and block execution until authorized. - Tags: how-to-guide - Published: 2026-08-12 ### [Workspace Resolution and Isolated Execution Environment in Paperclip AI: A Technical Deep Dive](/paperclipai/paperclip/workspace-resolution-isolated-execution-environment-paperclip-ai) Explore Paperclip AI's workspace resolution and isolated execution environment. Discover how monorepo discovery, type-safe contracts, and Git worktrees ensure safe, independent agent runs. - Tags: deep-dive - Published: 2026-08-12 ### [Paperclip AI Secrets Management and Injection into Agent Runs: Implementation Guide](/paperclipai/paperclip/paperclip-ai-secrets-management-injection-agent-runs) Learn how to manage and inject secrets into Paperclip AI agent runs. Securely store, encrypt, and inject secrets via environment variables or API calls with zero-knowledge security and audit logs. - Tags: how-to-guide - Published: 2026-08-12 ### [How Paperclip Enforces Budgets During AI Agent Runs](/paperclipai/paperclip/how-budgets-enforced-paperclip-ai-agent-runs) Learn how Paperclip enforces budgets during AI agent runs with configurable policies. Prevent runaway AI costs by setting alerts or hard stops to automatically pause agents when spending limits are exceeded. - Tags: how-to-guide - Published: 2026-08-12 ### [Preventing Double Work with Paperclip AI Task Checkout and Locking: A Complete Guide](/paperclipai/paperclip/preventing-double-work-paperclip-ai-task-checkout-locking) Prevent double work with Paperclip AI's task checkout and locking system. Ensure only one agent owns an issue at a time, with automatic fallback for seamless collaboration. - Tags: how-to-guide - Published: 2026-08-12 ### [Paperclip AI Database Schema for Companies and Multi-Company Isolation](/paperclipai/paperclip/paperclip-ai-database-schema-companies-multi-company-isolation) Explore the Paperclip AI database schema for robust multi-company data isolation. Discover how a single-tenant architecture with mandatory company_id ensures secure data separation. Learn more. - Tags: architecture - Published: 2026-08-12 ### [Paperclip AI Heartbeat Scheduling and Execution: How Timer-Based Automation Works](/paperclipai/paperclip/paperclip-ai-heartbeat-scheduling-execution-explained) Discover how Paperclip AI heartbeat scheduling and execution powers background automation with timer-based tasks. Learn about watchdog sweeps and maintenance runs. - Tags: deep-dive - Published: 2026-08-12 ### [How to Create a Custom Agent Adapter in Paperclip AI](/paperclipai/paperclip/how-to-create-custom-agent-adapter-paperclip-ai) Learn how to create a custom agent adapter in Paperclip AI by implementing the Adapter interface exporting from a new package and registering it in the registry. - Tags: how-to-guide - Published: 2026-08-12