agent.clavue.com
Cloud Agents
Cloud Agents is the hosted task surface at https://agent.clavue.com/. It runs staff-style work against a repo working copy and the same Clavue membership as Chat, Bot, CLI, and imux. The phone and web clients already speak to that fleet through /api/clavue-bot/ on www.clavue.com.
Overview
A cloud agent is a Bot employee with a thread, not a second account. You sign in once on www.clavue.com. The agent site, Chat, and the Bot API all read that membership. Tasks stay on the Clavue quota ledger.
- Product host: https://agent.clavue.com/
- Staff HTTP API: https://www.clavue.com/api/clavue-bot/
- Same plans as Chat and api.clavue.com/v1
- Docs for the Bot product itself live at /docs/bot
SSO login
Sign in on https://www.clavue.com/account. Family hosts that only see a parent-domain cookie use the SSO hop, which re-issues imux_membership_session with Domain=.clavue.com and redirects. The return URL is an exact-hostname allowlist. It includes www.clavue.com, chat.clavue.com, api.clavue.com, router.clavue.com, agent.clavue.com, mail.clavue.com, relay.clavue.com, nas.clavue.com, track.clavue.com, and explorer.clavue.com, and also clavue.com, www.iccjk.com, iccjk.com, localhost, and 127.0.0.1. agent.clavue.com and mail.clavue.com are on that list. A return host that is not listed is refused and the hop falls back to Chat, so it cannot be used as an open redirect.
https://www.clavue.com/api/membership/auth/sso?return=https://agent.clavue.com/Spawning cloud tasks
Open a staff thread, then post a turn. Listing bots does not start work. GET /v1/bots/:id is not the spawn call — the mobile client deliberately avoids it because that route can attach a paused routine. Spawn and continue with POST .../chat. Stop a running turn with POST .../stop.
- GET /api/clavue-bot/v1/bots — roster, hidden staff omitted
- GET /api/clavue-bot/v1/conversations?limit=20 — recent threads
- GET /api/clavue-bot/v1/bots/:botId/threads — threads for one employee
- POST /api/clavue-bot/v1/bots/:botId/chat — one turn on a thread
- POST /api/clavue-bot/v1/bots/:botId/stop — stop that employee
Repo and worktree connection
Cloud tasks attach to a working copy, not to a second git origin. Clavue hosts the working tree the agent edits. GitHub or the repo you already use stays origin. imux and the worktree docs describe the same rule for local panes: parallel trees, no stolen remote.
- Point the task at the repo URL the agent is allowed to read
- Prefer a dedicated worktree over the branch you are typing on
- Review diffs before they land. The agent does not push unless the task says so
- Local imux worktrees stay on your Mac. Cloud tasks stay on the hosted copy
# Local counterpart — see /docs/worktree
# Cloud Agents use the hosted working copy for that task.API integration
Call the Bot API with the same session you use for Chat: cookie imux_membership_session, or Authorization: Bearer with a device-login session token. There is no separate Cloud Agents key. Read a thread before posting if you need context. The board endpoint is a read for that employee.
curl -s "https://www.clavue.com/api/clavue-bot/v1/bots" \
-H "Authorization: Bearer $CLAVUE_TOKEN"
curl -s "https://www.clavue.com/api/clavue-bot/v1/bots/$BOT_ID/threads" \
-H "Authorization: Bearer $CLAVUE_TOKEN"
curl -s "https://www.clavue.com/api/clavue-bot/v1/bots/$BOT_ID/chat" \
-H "Authorization: Bearer $CLAVUE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"threadId":"'"$THREAD_ID"'","text":"Summarize the failing test"}'Security
The agent runs with your membership, so a prompt is a capability. Do not paste peer-tool credentials, signing keys, or another product's home directory into a task. The roster is readable. Chat and stop are writes. Treat a cloud worktree like a shared machine: review the diff, then keep or drop it.
- 401 means the membership session is missing, not that the bot id is wrong
- Do not send ~/.clavue, ~/.grok, or cloud keys as task files
- Stop the employee when a turn should not continue
- Official model calls from a task still bill the same quota as api.clavue.com