Skip to main content

Paperclip: Open Source Human Control Plane for AI Labor — Dotta Bippa

TL;DR

  • Paperclip is an open-source AI agent orchestrator designed as a "human control plane for AI labor," allowing users to build and manage a hierarchical organization of AI agents.
  • It enables users to define tasks, assign projects, and implement workflows (like QA and routines), ensuring agents work reliably, adhere to instructions, and leverage shared context like branding guides.
  • The platform is model-agnostic, supporting various AI agents and offering features for cost management and a focus on business operations beyond just coding, making it accessible to a wider audience.

Takeaways

  • Orchestrate AI Agent Organizations: Build and manage an org chart of AI agents, defining their roles and reporting structures to accomplish complex tasks collaboratively.
  • Bring Your Own Agents: Integrate any AI model (e.g., Gemini, Claude) into Paperclip, allowing these "employees" to communicate, store memory, and negotiate within the system.
  • Guide Agents with Instructions and Skills: Provide detailed instructions to individual agents and install specific skills (e.g., Re-motion best practices from skills.sh) to refine their behavior and output.
  • Implement Workflow Reliability: Utilize features like QA agents with agent browser skills, reviewer/approver roles, and routines (scheduled or manual task sequences) to ensure agents reliably complete work and meet quality standards.
  • Leverage Organizational Context: Agents in Paperclip automatically access shared context like internal dashboards, branding guides, and learned preferences, reducing the need to provide redundant information.
  • Start Small and Scale Thoughtfully: When building an AI organization, begin with a few agents and carefully craft their expected behavior before expanding to larger, more complex team structures.
  • Optimize AI Model Costs: Manage expenses by setting per-agent and per-project budgets, and leverage platforms like OpenRouter to access cheaper or free AI models for less critical agent roles.
  • Focus on Business Operations: Paperclip is designed as a vendor-neutral tool for managing diverse business functions, including marketing, sales, and finance, not exclusively for coding or code review tasks.

Vocabulary

  • AI agent orchestrator — A system that manages and coordinates the actions of multiple AI agents to achieve a larger goal or task.
  • Human control plane — A metaphor describing Paperclip as the interface where human users guide and direct AI labor, rather than the AI being fully autonomous.
  • Org chart — An organizational chart within Paperclip where users define a hierarchical structure of AI agents, each with specific roles and reporting lines.
  • Agentic surface — Refers to the capability of an AI agent to perform complex actions like hiring other agents or installing new skills within the Paperclip ecosystem.
  • Skills.sh — A platform or repository for discoverable and installable skills that AI agents can acquire to perform specialized tasks.
  • Agent browser skill — A capability that allows an AI agent to interact with web browsers, performing actions such as opening websites, filling out forms, or clicking buttons.
  • Vendor-neutral harness — A system design that allows users to integrate and manage AI models from various providers (vendors) within a unified workflow.
  • Routines — Configurable, reusable sequences of tasks or actions that can be scheduled to run automatically or manually, often with customizable variables.
  • Meta-agents — Agents whose primary role is to monitor, diagnose, or improve the performance and skill utilization of other agents within the organization.
  • Maximizer mode — A future feature in Paperclip designed to make agents work relentlessly and continuously towards a dream goal, burning tokens as needed without stopping.

Transcript

Welcome to getting started with paper clip and I am Dota your host and the creator of paper clip And I'm so excited to show you how to get started with this brand new open source Agent orchestrator. I'm gonna walk you through your first steps of how to get Paper clips started what it looks like when you have a huge organization and some of my best advance tips for working with AI agents and So you can create your own own Human company now the tagline that we have for paper glib is that it's for open source orchestration for zero human companies You can hire employees set goals automate jobs your business can nearly run itself well You know, maybe that's a bit of a headline. I would say that paper clip is the human control plane for AI labor Really the idea behind paper clip is that you are able to set up an award chart of agents where you can manage them all and invoke your taste in what these agents how they work and Have them complete real work So let me walk you through a little bit how it how to get started the first thing that you do is you should just open up Your terminal and run npx paper clip AI on board you can pass dash. Yes. If you want the default options But when we talk about like what is paper clip paper clip is a A way that you can accomplish real work that you are accountable for Using AI agents. Maybe you've seen tools Where they have you create a task and then automatically creates a business for you with paper clip You actually are involved in the steps to have your preferences accounted for and And you are involved in the task Process from the higher level design all the way to actually executing so what I'm gonna do here actually I'm gonna show you This is the real instance that I use To manage paper clip itself And I'm gonna walk you through a little bit this kind of finished product And then we'll start a brand new company and I'll show you how you can do it on your own So this is the company that I use to manage paper clip itself. You've got here the CEO who's the man in charge We've got a CTO and under him he has quite a lot of coders I would say that the two coders that I use the most would be the codex coder as well as the clawed coder And an important thing about paper clip is that you bring your own agent So you can use Gemini you can use Pi you can use Hermes you can use OpenClaw a key part of Paperclip is that any agent that you want to use can be brought into paperclip as a employee and then it can sort of Negotiate and communicate and have its memory stored with the rest of paperclip If you look over here for a quick example, we've got our marketing organization and And one of the things that we have here under the CMOs content strategist and also a video writer now We've been super thankful with how quickly paperclip has grown. We actually crossed this week 40,000 GitHub stars which I was stoked about And it's really through kind of the contributions of the whole community probably by the time you're watching this We've already crossed 50,000 stars now normally what I would do is I would actually just Publish a tweet or at most a screenshot celebrating 40,000 stars and call it a day But I realized you know I wonder if I can use paperclip to accelerate this process And so what I did is I came in here and I created a new issue and I assigned it to my CEO The idea behind paperclip is that you are the CEO and you are working You are basically giving your CEO instructions and then your CEO is designed to Break down the tasks to your executive branch and then down to the individual Contributors so one of the things that I did is I asked the CEO Please hire a video writer and have them write a Re-motion video celebrating 40,000 stars So here's the thing Every piece of the paperclip app has an agentic surface So your CEO knows how to hire new agents they know how to install new skills There is a skills manager built into paperclip so for example, I'm sure you've seen skills.sh From there, we would install the re-motion best practices skill The CEO knows how to find this and do this and Re-motion if you don't know is a open source react Actually, I don't know if it's a react base. It's an open source tool that you can use for creating videos You don't need to sign up for anything The CEO hired our video writer agent and gave her the Re-motion best practices skill. Yeah, video creation and react And from there I was able to create a prompt to say plan this video for the stats dashboard So I say go look at the dashboard. We're at mentioning another project that we already have We already had a dashboard and our stats are stats. You know these agents can don't mind typos Make a plan for a re-motion video that we can create that celebrates 40,000 stars So this was my entire prompt right here to make this video that I showed you Over here. I wrote this prompt and then the agent wrote this plan um Paperclip has first-class first-class support for plans and um, then after I read the plan briefly I gave it some feedback I said you know what your cuts need to be like two seconds not six and just have the 40,000 stars animate etc Right, so I go through here and I actually give my agent We have a bit of a conversation around how we want the video to look and then bam within about Five minutes we had this like beautiful animation that is on brand that's the real stats It has charts and and and so the question is like well, how did it have all this context and the answer is that it had it from Paperclip, you know you could do this with Claude Code and what you would have to do is you'd have to go track down all your stats You would have to track down your brand guide You'd have to give it the re-motion skill you have to give it access to your dashboard With paperclip all of those things are built into this system. So for example We already have the dashboard. We already have a paperclip branding guide which the agents already know about for the brand identity. So when we create videos we know that it looks good and Something that might have taken me a week actually becomes an afterthought with paperclip. So Um, let me point out another really interesting thing here is because we are now um creating multiple videos we've created some other videos with this same agent We actually can go over the list of feedback that we've given our agents and learn how to make the skill better where we have not only a generic remotion skill But also a paperclip specific skill that has our branding guides our preferences our style like pacing choices Right, if we start to see that The agents are always having their cuts be two seconds and not six then That gives us something that we can learn from over time and so for now how that happens is you create an agent Which learns from the conversations, but this will be something that's built more into paperclip in the future versions Something I want to note is that we released paperclip on March 4th. It is now April 8th. So we're looking at something like 34 days give or take of it being in open source We've already had an incredible amount of pull requests and I want you to know that is getting better every single day So this would be one of the like sort of most simple ideas with paperclip, which is hopefully it looks sort of obvious you Have an org chart where you create these agents. You can configure them however you'd like You have projects which are very familiar to the sort of like task management interface And then your agents are assigned these projects and then they These tasks and And then they work through the tasks to complete the work But of course as anyone knows Keeping them on task can always be a bit of a challenge and so paperclip provides a variety of kind of workflows that are important to the orchestrator in order to actually Complete the words successfully So for example one of the main things that you will often see in a good paperclip organization would be QA The QA agent has the agent browser skill which is a skill that lets you trigger task like open a website fill out a form click a button Probably if you use agents you're already using this skill And one of the things that you'll want to be able to do is have it configured such that Your tasks are require a reviewer or potentially an approver and this idea is I'm sure you've tried this in Claude Code before where you might have 30 Claude Code tabs open you can't remember what they're all working on and you um And and then you ask your coding agent to say hey, please test this in the browser before you send it back to me And what happens it doesn't do it right Um you you and so people are creating all sorts of these complicated hooks and harnesses But of course hooks only work one way in Claude and another way in codex And everyone knows that these agents just have such different personalities Anyone who does work at agentic work knows that you really want to be able to pull in models from lots of different labs and And and so paperclip gives you this kind of vendor neutral harness where you can create these higher level workflows where you can say When the assignee is complete is finished with this task You must have the qa agent boot and give a review on it you also Can have an approver right? So these are two sort of different roles because Qa might review it and then you iterate between the coder and the reviewer and but the manager might be the one who kind of approves it and says Yes The work that the two of you did is sufficient to be take part in our organization and our brand so One of the things that you will find when you use paperclip is that there's just this higher degree of reliability To making sure that your agents actually complete the work that you instructed them to do so There are other ways that you can have workflows with your agents for example, we have routines One of the things that I use paperclip for a lot is I use Twitter bookmarks to be able to track ideas that I'm interested in especially to improve paperclip so we can come here and look at some of the bookmarks Let me see we can look here at some of the bookmarks that I saved a day ago and Within the routines Section what you're able to do is is set up things like you know, here's how we deal with a PR Create a discord message of everything that was merged into the master branch today write the release change log And you can sort of group these by project or agent and and these would be things that you can set up to run on a schedule Or you can also set them to run manually with template variables in them like for example You know create a single PR in this branch and and then when we go to run it You've got these variables where you can put in the branch that you're talking about so When you finally have these reusable tasks that you're you know Instead of kind of having a prompt folder or I've been a copy and paste um You can create these routines, you know it overlaps a little bit with um skills for example You you also can use your skills in your routines of certainly there's a bit of like overlap in terms of how you manage it Right, maybe you already have a PR branch for PR merging skill for your organization. You should certainly Use that for example for the open source project we use Grep tile in order to do code reviews first pass code reviews for community contributions And you can see here in this routine We say use the grip loop skill after you've submitted the PR and that way um it will go to GitHub. It will review the changes uh And and come back But I will say that this right here is very much a kind of coding workflow and the important thing I want you to understand about paperclips it is not a coding tool Paperclip is not a code review tool paperclip is designed for creating businesses if you are a coder and you like using cursor or GitHub you can use those But you do not have to be a coder to use paperclip um you can use paperclip to To to run your marketing to help deal with sales leads to Deal with finance operations. This is designed to be a tool that everyone in your organization can use to Wrangle AI agents so if we go back to this example of Looking at our bookmarks for example here's one where we have the report where there's a bookmark strategy report where we look at You know some of these these other execution adapters some memory adapters um The ideas around uh using CLIs versus chat and Today when you look at this uh what paperclip has produced is simply a report However, uh the paperclip of tomorrow will have buttons in here where you can say well create an issue out of this Why don't you create a plan for this? Why don't we why don't we start to integrate this as a feature into our app where we'll be servicing a lot more of sort of action into uh what you are The work products that you are sort of getting out of paperclip so um This is sort of the first version of paperclip. You can see that I've got a lot of Other companies over here when you create your own company you'll be prompted. We can say oh let's say You know dota's mcp directory. Let's say we wanted to have a mcp directory where we uh like Like like like a like agent tools directory. Let's call it this agent tools directory and The goal of this company is to charge for hosted agent tools. We are a proxy for all third-party tools. So your agent Just has to auth one time and you can control control it right something like this The initial agent we might hire is the CEO you can see we've got all kinds of addition additional agent types Gemini open code hermys pie cursor I prefer Claude Code or codex for your CEO. I think that's a good idea and uh then from there after this agent is created we say hire your first engineer and create a hiring plan now again Your work might not have anything to do with engineering you might be doing with marketing or Sales or something else so feel free to edit your initial task, but we can just leave this now. We can say uh The initial product will need Partners from the large SaaS companies or whatever you want to think about your business That's you know these tools can do anything Except know what you value and so what you need to be able to do is to communicate accurately What you sort of expect this to do so you can see we've got a new org here this org really only has one agent our CEO Our CEO right now is working on our hiring plan um and we'll sort of watch him and uh let him work will let him do his work Now one of the things that i would tell you as you are building out your organization we have um There are templates that exist where you can import huge organizations by default and try to use them my suggestion for you When you're just getting started with agents is just start with the agents that you need you don't actually have to install Something like uh that has 130 agents and a huge marketing team and um you know you you really like if you if you don't take the time to kind of craft For the agents how you expect them to behave then you won't get good results. Okay. Look here our CEO is actually um uh As asking us if they can hire a CTO great we will approve this we approve you may hire this chief technology officer And um now that we've approved it will sort of let him him work so Yeah, some of the key things that i want to tell you is that you need to build your organization Sort of agent by agent make sure the quality level is high and then it actually necessitates you Fanding out into other agents um you know everything that you do might not need to pay frontier model prices you might not need to pay um Claude for example for or or or or open a i for every agent maybe just your most intelligent agents need to do that We support um open code and open router through open code as an agent Which means that you can go to their router and you can find all sorts of other Models that will be cheaper. I mean look here the quen 3.6 plus is actually free right now So you could hire an agent that uses quen 3.6 plus and You will won't have to pay for inference until you sort of hit the limits and so Yeah, I think open router is a great resource for kind of uh Maybe some agents for which these models are good enough That said I would also say that many of these models won't be great for intelligence services you may need some better models for For your best work. So Here you go you can see that we've got our first engineer and create a hiring plan. We've got a hiring plan here The CEO says all right phase one hire a cto then Core engineering go to market whatever we have approved it and now We just want to say like we approve the plan keep going Right, so we'll tell the CEO that we approve and he is able to hire the rest of the crew Now one of the things with paperclip is it does keep track of your monthly spent you can set budgets per agent and budgets per project We you're seeing zero monthly spent here because we are able to use the subscriptions at the moment We're using subscriptions for both clawed and codex of course as your team scales up that might not Be the case all right, so you can see our CEO has started A bit more like work where we're building prototype SaaS partner integration setting up development infrastructure Defining the product infrastructure all of these agents are live By default the agents are actually configured to only run One in parallel so if you are getting kind of nerdy you can dig in here to the concurrency and add more We're just going to leave it on the defaults for now And one of the important things I want to tell you is it is very important that you Your agents to do what you want them to do so let me show you my codex coder I actually have instructions here that I am constantly working on like I'm adding things by saying you know If there's a block or tell us your best guess on how to fix it Don't just say it's blocked say he give me a tutorial on how to fix it if you write tests Don't write the whole test suite and so on right? I'm giving my agents instructions on a regular basis whenever they do something wrong You want to stop and take the time and have it do Better we even start to create sort of meta agents like here We have a skill consultant and the skill consultants job is to actually work with the other agents within the organization To make sure that they're using their skills to the best their ability when we have an agent that isn't using skills that we expect We come and we ask the skill consultant to sort of do a diagnosis and iterate on it and I would say in the version that you're seeing a paperclip today many of these steps are manual This kind of organizational learning is something that we are building into paperclip to happen for you automatically now This paperbook version is very very early. There's some missing missing pieces. We have introduced experimental support for Work spaces so you can have isolated work spaces This is more of a coding thing where you can manage pull requests and Work trees we are adding features like the CEO Chat so you can see our roadmap here on the GitHub repo Hey, look at this. We just crossed 50,000 stars. You are here for the first moment that I saw express 50,000 stars incredible So You can see our roadmap here where we talk about that we are going to add more about artifacts and deployments We're going to add a CEO chat We're adding maximizer mode Which is when you've got a dream and tokens to burn and you want the agents to work as hard as they can To do whatever it takes to create your Business and you want them to keep going without stopping that would be the paperclip maximizer Another piece you'll notice is missing is that there's not multiple human users That is a huge gap. We are working on this feature really this week Because you should be able to deploy it to a Claude and have your entire team work on paperclip We're also working on Claude and sandboxing agents so that you'll be able to run agency in e2b or dev.dxc or Claude agent deployments any of these things And we're also working on a desktop app which will be a free open source desktop app and Claude deployments We'll host a paperclip Claude and really just general like stability Working with memory the knowledge base these are all sort of features that we'll be adding over the next 30 days So probably by the time you're watching this video Check out the latest version of paperclip because you will see a lot more of these features Into the app and it will be that much more powerful So well that is paperclip in a nutshell You can see that our agents are working to set up the deployment infrastructure or the cip pipeline Building some initial partner integrations. I think one of the first things we're going to want to do is have it work on the marketing And really the idea with paperclip is it's a free product that will give you the power as a human to Have control over AI labor do not worry about AI taking your job But when you use something like paperclip you will be in charge of thousands of agents Helping you build your business helping you with your company Paperclip is a free tool that you can use To manage the chaos of work where you can debug What's happening you can guide your individual employees you can provide them the context they need to do the work that's required to bring it up to the quality of your brand So yeah go to paperclip.ing right now Type this command fire a paperclip even if you're not technical you can use paperclip today To help you with your AI agent so thanks so much and uh Go download paperclip

Feedback / ReportSpotted an issue or have an improvement idea?