paperclipai

library2026.416.0jsnpmunverified

Paperclip CLI is a robust command-line interface designed for orchestrating and managing teams of AI agents to automate and run business operations. Currently at version 2026.416.0, the project demonstrates a rapid development and release cadence, with multiple significant updates often occurring within weeks. Its key differentiators include a modern chat-style interface for managing agent issues, flexible multi-stage execution policies, comprehensive features for importing and exporting entire 'agent companies,' and a powerful plugin framework with an accompanying SDK for extensibility. Paperclip CLI integrates seamlessly with a wide array of popular AI models and CLIs, such as Google Gemini, Cursor, OpenCode, Pi, Claude Code, and Codex, providing a unified platform for deploying and overseeing diverse AI-driven workflows.

llm-agents devops workflow

npm install paperclipai

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PAPERCLIPAI

paperclipai

llm-agentsjavascriptv2026.416.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

PaperclipAgent

✓ import { PaperclipAgent } from '@paperclip/sdk';

✗ import { PaperclipAgent } from 'paperclipai';

The `paperclipai` package is primarily a command-line interface (CLI) and is not intended for direct programmatic imports into end-user applications. Programmatic interaction, such as defining custom agents or extending functionality, is typically achieved through a dedicated Plugin SDK, which is usually found under a separate package name like `@paperclip/sdk`.

IssuePolicy

✓ import type { IssuePolicy } from '@paperclip/sdk/types';

When developing plugins or extensions for Paperclip, type definitions for core concepts like `IssuePolicy` are generally imported from a dedicated types module within the Plugin SDK. This ensures type safety and consistency when interacting with Paperclip's internal structures.

CompanyExporter

✓ import { CompanyExporter } from '@paperclip/sdk/cli-utils';

Utility functions that mirror or assist with CLI operations, such as company import/export, might be exposed via specialized modules within the Plugin SDK (e.g., `@paperclip/sdk/cli-utils`). This is primarily for advanced plugin developers or those extending Paperclip's CLI itself, rather than general application development.

This quickstart demonstrates how to initialize a new AI agent company, add a 'ContentCreator' agent utilizing the 'gemini-pro' model, assign it a task (creating a blog post), and then launch the Paperclip dashboard to monitor its progress and interactions.

npx paperclipai company create --name "MyAICompany" --template "default" npx paperclipai agent add --company "MyAICompany" --name "ContentCreator" --model "gemini-pro" npx paperclipai issue create --company "MyAICompany" --agent "ContentCreator" --title "Draft Blog Post on AI Trends" --description "Generate a 1000-word blog post about the latest trends in AI, focusing on LLMs and ethical considerations. Include relevant keywords and a call to action." npx paperclipai dashboard

paperclip --version

Debug

Known issues

gotchaPaperclip CLI integrates with various external AI models (e.g., Gemini, Claude). It's crucial to correctly configure your API keys for these services, either through environment variables or Paperclip's internal settings. Incorrectly configured or missing API keys are a primary cause of agent operational failures and authentication errors.

fix

Consult the Paperclip documentation for the specific AI model you are using to ensure proper API key setup. Typically, this involves setting environment variables like `GEMINI_API_KEY` or using Paperclip's `config` command.

affects: >=0.3.0

breakingWith version 2026.416.0, the traditional comment timeline for issues was replaced by a full chat-style thread powered by `assistant-ui`. Any custom tools, scripts, or integrations that programmatically interacted with the old comment structure for issues will require updates to align with the new conversational model.

fix

Review and update any automation that reads from or writes to issue comments. The new interaction paradigm may require different parsing or interaction methods if you were previously scraping or injecting directly into the comment timeline.

affects: >=2026.416.0

gotchaAI agent operations can incur substantial costs due to frequent API calls to underlying language models. Users are responsible for monitoring their usage with AI service providers. While Paperclip might offer some local execution modes or cost tracking, it does not inherently prevent external billing.

fix

Set up budget alerts with your AI model providers. Actively monitor agent activity and optimize prompts to reduce token consumption. Utilize local adapters and sandbox modes when available to minimize production costs during development and testing.

affects: >=0.3.0

gotchaPaperclip has a very aggressive release schedule. While this brings rapid innovation, it means the API and CLI options can evolve quickly. Although major breaking changes are usually highlighted, minor behavioral shifts or new flags can appear frequently.

fix

Before major deployments or significant feature utilization, it is recommended to review the latest GitHub release notes. Consider testing in a staging environment to catch any unexpected changes or new requirements. Use `npx paperclipai --version` to confirm your installed version.

affects: >=0.3.0

Errors

Common errors & fixes

Error: Node.js version unsupported. Paperclip requires Node.js >=20.

The system's Node.js version is older than the minimum requirement specified in `package.json` (`>=20`).

fix

Upgrade your Node.js installation to version 20 or higher. Using a version manager like `nvm` is recommended (e.g., `nvm install 20 && nvm use 20`).

Error: Failed to authenticate with AI provider. Invalid API key or missing credentials.

The API key for an integrated AI model (e.g., Gemini, Claude) is either missing from environment variables/configuration, or the provided key is invalid/expired.

fix

Ensure the correct API key is set for the specific AI model. This often involves setting an environment variable (e.g., `export GEMINI_API_KEY='your_key_here'`) or configuring it via `paperclipai config` or the web dashboard.

Command failed with exit code 1: paperclipai agent add --name "..." --model "unknown-model"

Attempting to add an agent using an AI model name that Paperclip does not recognize or support, or if a required local adapter for that model is not installed/configured.

fix

Verify the exact model name with `npx paperclipai help agent add`. Ensure any necessary local AI CLIs (e.g., Google Gemini CLI for its adapter) are installed and properly set up on your system as per Paperclip's integration guide.

Upgrade

Version history

2026.416.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

21 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/paperclipai/paperclip ↗

packagehttps://www.npmjs.com/package/paperclipai ↗

homepagehttps://paperclipai.com ↗