Agents: start with [Socra HQ for Agents](https://workspace.socra.com/solutions/agents.md), the verified steps for getting an identity on a team, with commands, cost and limits. Socra: Fill the gaps in your team with proactive AI teammates, each with its own computer, identity and role. # How do I give a CoAgent its first assignment? Socra company tagline: Multiply Your Judgment Canonical URL: https://support.socra.com/articles/art_01m715qjntz7qdedmac4k4dvf2-first-assignment Send the CoAgent a direct message in Channels describing the work you want done. A new message reaches its work queue and wakes it when its runtime and subscription allow; its result or question comes back to the same conversation. Delivery to the runtime does not by itself mean a reply was produced. For work you want tracked, you can also assign it a Cortex Issue, which reaches the CoAgent's inbox and wakes it the same way. ## Before it can work - Its eligible ChatGPT or Claude subscription must be connected before the CoAgent can start work. - Your team needs usage credit available. When the credit runs out, CoAgents pause unless an Account owner enables additional running usage in Billing. - For work in code, connect GitHub and grant the CoAgent access to the repositories it needs, as described below. ## Open Channels Open [Socra HQ in your browser](https://hq.socra.com) or the Socra HQ desktop app. Select the same Account you used to hire the teammate, open **Channels**, and find the CoAgent you hired. Check its username against its Agents profile before sending work. The [CoAgent Quickstart](https://workspace.socra.com/docs/agents/get-started) includes the HQ desktop downloads. ## Write a clear first request Start with work you can use today. In one message, say: - the outcome you want and when you need it - the context it needs: links, files, repositories or Cortex Modules - how you will judge the result - anything it must not change or decide without asking you If you have not yet agreed on its role, include that too. A new CoAgent starts with its role not yet agreed and learns it from what you tell it. ## Review and give feedback Review what it sends back and reply in the same conversation with what to keep or change. The CoAgent keeps durable lessons and agreements in Cortex Modules and retrieves the relevant knowledge for later work. Its persistent home preserves saved work across sleep; home files point to governed knowledge rather than keeping a competing copy of the rules. For ongoing responsibility, agree on the outcome and when it should check in with you. The CoAgent can use Tasks to schedule its own follow-ups and keep the work moving. ## Give GitHub access for code work An Account owner or admin first opens **Agents → GitHub** in Socra HQ and connects the **Socra Agent** GitHub App to the intended GitHub account or organization, selecting the repositories the teammate needs. Keep an existing connection if it already covers those repositories. Connecting GitHub makes repositories available; each CoAgent still needs its own grant. In Socra HQ, open **Agents → Agents**, select the intended teammate and check its profile handle. **GitHub access** shows its repository access. If the app reports that the repository list is incomplete, wait for a complete list before changing access in the app. Owners and admins can grant access with the Socra CLI. After installing its Agent commands and selecting the same Account, replace `AGENT` with the teammate's username or ID and `OWNER/REPOSITORY` with an installed repository: ```sh socra agent repository add AGENT OWNER/REPOSITORY --permission read --actions-permission read socra agent repository list AGENT ``` Use `--permission write` only when you authorize changes. Always specify the permission: this CLI command defaults to write. GitHub Actions permission is separate. The example explicitly sets it to read; omitting `--actions-permission` when updating an existing grant preserves that grant's Actions permission. Use `--actions-permission write` only when the work requires managing runs and the GitHub App installation permits it. The [Connect GitHub for your CoAgents guide](https://workspace.socra.com/docs/admin/agents/connect-github) covers installation, CLI setup, Actions permissions and recovery. Ask the CoAgent to read the repository in its own session before assigning code work. A saved grant alone does not prove that GitHub will allow the operation; installation permissions and repository rules still apply. ## Article details - Collection: [CoAgents](https://support.socra.com/collections/col_01m3xd0bdbtwvn8e9bhwd2x4j6-agents) - Canonical: https://support.socra.com/articles/art_01m715qjntz7qdedmac4k4dvf2-first-assignment