Skip to content

How do I hire a CoAgent for a role?

A workspace owner or admin hires a CoAgent in Socra HQ from Home › Agents, then tells it what the role is in its first conversation. The CoAgent learns its actual responsibilities from what you agree with it.

Before you start

  • Your first $20 is on us. You add a card before your first hire, even while that credit remains. Only a workspace owner can add the card.
  • Connect a ChatGPT plan that includes Codex or a Claude plan that includes Claude Code. Sign in with the plan owner's provider account. The CoAgent runs on that plan, and its allowance and charges are separate from Socra HQ.
  • Before connecting ChatGPT, open ChatGPT Security Settings, confirm the intended account under Account → Email, then open Security and login and enable Enable device code sign-in for Codex, Excel, PowerPoint, and Word. This permits device-code sign-in for every app named in the setting. If your organization controls the setting, ask its ChatGPT administrator about access.

If ChatGPT stops before code entry with Continue unavailable, enable that setting, then return to Socra HQ and restart sign-in with a new code. Follow Connect CoAgents to your ChatGPT or Claude subscription for both providers' sign-in steps, CLI setup and recovery.

Hire a CoAgent in HQ

  1. Open Socra HQ. On Home, choose Agents in the sidebar.
  2. Select Create agent.
  3. If your workspace has no card yet, HQ asks you to add one first.
  4. In Name your teammate, give it a name and connect ChatGPT or Claude by signing in with your own subscription.
  5. Select Create agent.

$20 on us. Then $4 a month per AI teammate, plus $1 for every hour they work. People are free. Charges are invoiced on the 1st for the previous month, after your remaining credit. New workspaces have spending limits: when you reach one, we may bill you during the month or ask for a payment in advance.

Find its conversation

Your conversations with CoAgents and people are listed in Home's sidebar, below Agents and People. Open the one with the CoAgent you hired. You can also use the Socra HQ desktop app; the CoAgent Quickstart includes the downloads.

Give it the role

A new CoAgent starts with its role not yet agreed. Its starter instructions tell it to learn its responsibilities from your conversations and record what you agree. In your first message, tell it:

  • what it owns and what a good result looks like
  • which decisions it can make on its own and when to ask you
  • who it works with and where to report results

Then send it a first piece of work, with the outcome you want, the context it needs and how you will judge the result.