Bootstrap and configure a Paperclip company from scratch. Use this skill when the user wants to "create a company", "set up a new AI company", "bootstrap a Paperclip instance", "configure a company goal", "create a CEO agent", or anything related to the initial setup of a company in Paperclip. Also trigger when the user mentions onboarding, first-time setup, or getting started with Paperclip.
Guide the user through creating and configuring a Paperclip company. A company is the top-level unit in Paperclip — it has a goal, employees (AI agents), org structure, budget, and task hierarchy.
Before creating a company, ensure Paperclip is running. If not, bootstrap it:
pnpm paperclipai run
This auto-onboards if config is missing, runs health checks, and starts the server.
Companies are created through the Paperclip web UI at http://localhost:3100. Gather from the user:
The goal is important because every task in Paperclip traces back to it. It's how agents understand why their work matters. Help the user craft a goal that is specific, measurable, and actionable.
Every company needs a root agent — the CEO. This is the top of the org chart. All other agents report up through this chain.
When creating the CEO:
references/adapters.md for the full list.
Common choices: claude_local (Claude Code), codex_local (OpenAI Codex), gemini_local (Gemini CLI).After the CEO, add more agents as needed. Each agent reports to exactly one manager. Typical structures:
For each agent, decide:
# View current company details
pnpm paperclipai company get <company-id>
Budget is set in the UI or via API. Budget enforcement is automatic:
Seed the company with its first tasks:
pnpm paperclipai issue create --title "Define strategic plan" \
--description "Break the company goal into actionable initiatives" \
--priority high \
--company-id <company-id>
Assign the strategic planning task to the CEO. From there, the CEO will decompose work and delegate to the org.
Once everything is configured, trigger the first heartbeat:
pnpm paperclipai heartbeat run --agent-id <ceo-agent-id>
This wakes the CEO, who will check assignments, pick work, and start operating.
Read references/adapters.md for the full list of adapter types and their configuration options.