Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 04:45 UTC
docs: document agent account claim and route credential-less agents to agent signup (DEVREL-134) (#5373)
Part of [DEVREL-134](https://linear.app/composio/issue/DEVREL-134/make-agent-signup-discoverable-across-composio-website-docs-and). ## Problem Most of the agent-signup docs work has already shipped (#4434). The quickstart, `cli.mdx`, the agent-setup index, the authentication reference, and the docs `llms.txt` all link to [Authenticate an unattended agent](https://docs.composio.dev/docs/agent-setup/unattended-authentication). Two gaps were left: - The guide never mentioned handing the agent account to a person, even though the CLI ships `composio agent claim <email>`. - The bundled Composio skill (`skills/composio/SKILL.md`) never mentions agent signup. An agent that has only the skill, no key, and no human available has no documented next step. ## What changed - **`docs/content/docs/agent-setup/unattended-authentication.mdx`**: new "Hand the account to a human" section covering `composio agent claim <email>`. - **`skills/composio/SKILL.md`**: new stable rule 4. Reuse an existing credential first (`COMPOSIO_API_KEY`, a saved CLI login, or a saved agent identity). Use `composio login --agent` only when the task needs Composio, no credential exists, and no human is available. Mentioning Composio alone is not a reason to sign up, and an agent account does not authorize anyone's apps. Rules 4–11 become 5–12. Nothing references the rules by number. ## Evidence This is a docs and skill change, so there's no before/after output to show. I checked each claim in the new section against the CLI source: | Claim | Source | |---|---| | `composio agent claim <email>` invites the email as an admin of the agent org | `ts/packages/cli/src/commands/agent/claim/agent.claim.cmd.ts` (description: "Invite a human admin to claim this agent org.") | | Uses the saved agent key and fails when the CLI is signed in as a human | `resolveStoredAgentKey` in `ts/packages/cli/src/services/agents.ts` returns `humanLoginError()` when the current key isn't the stored agent's | | `composio agent whoami` reports `claimed_by`, `null` until set | `safeAgentSummary` (`claimed_by: identity.claimed_by ?? null`) and `formatAgentWhoamiJson` | Not run: the docs build and the static tests. Dependencies weren't installed because this ran on a shared machine. CI covers both. ## Details Out of scope here; the rest of DEVREL-134 stays on the ticket: - composio.dev homepage, For You, and footer links belong to the marketing site. - The fresh-agent discovery audit stays manual and is tracked on the ticket. - Toolkit page and package README links are on hold. ## ELI5 Agents can already create their own Composio account from the command line. This PR tells them how to hand that account to a person later. It also tells the Composio skill to use a key the agent already has, and to create an account only when there's no key and no human to log in. --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>