{
 "schema_version": 1,
 "generated": "2026-10-24",
 "id": "jklthinking-retinue--assign-cards-to-ai-agents-on-one-board",
 "repo": "jklthinking/retinue",
 "repo_url": "https://github.com/jklthinking/retinue",
 "repo_slug": "jklthinking-retinue",
 "title": "Assign work cards to AI agents and check results on one board",
 "page_title": "How to assign work cards to AI agents and check results on one board with Retinue",
 "summary": "Give each agent a card with one holder, an acceptance line, and a receipt trail you can review.",
 "who": "A developer or team lead supervising several AI coding agents who needs one place to see who holds each task and whether it is really finished.",
 "problem": "Agent work gets scattered across chat threads and terminals, so nobody can tell which agent is doing what or whether a claimed result matches the request.",
 "outcome": "A running local hub where a card is claimed by one named agent, updated with progress and a result reference, and marked done only after its acceptance line is true.",
 "steps": [
  "Export RETINUE_ADMIN_PASSWORD with at least 8 characters, then run `docker compose up --build` from the repo folder.",
  "Run `curl -fsS http://127.0.0.1:9219/api/health` and confirm the JSON status is ok.",
  "Sign in as operator, open Administration, and prepare an executor with actor id worker-1. Save its one-time token outside the data volume.",
  "Open Task workspace, then Task board, then New task. Set the holder to worker-1 and write an acceptance line the agent can check.",
  "Have the agent claim the card and post progress with its agent token as a bearer header to the card update endpoint, then set the status to done once the acceptance line is true."
 ],
 "agent_prompt": "Using the Retinue repo at <repo path>, start the hub with docker compose up --build and confirm /api/health returns status ok. Create a card for actor worker-1 with the acceptance line in <acceptance text>, then claim it and post progress through the update endpoint. Report the task id and the final status, and verify that a token for a different actor gets 403 holder-only-writes.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "45 minutes",
 "basis": "readme",
 "caveat": "The README's quick path stays on loopback, so reaching the hub from another machine needs the exposure steps in SELF_HOSTING.md and is not covered here.",
 "category": "Work and operations",
 "tags": [
  "Work and operations"
 ],
 "lang": "python",
 "requirements": [
  "Docker with Compose installed",
  "Host port 9219 free on the machine that will run the hub",
  "An admin password of at least 8 characters",
  "Python for the optional MCP install (pip install 'retinue[mcp]')",
  "An agent that can send HTTP requests or speak MCP"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The one-time agent token and the admin password grant write access to the board, so store them outside the data volume and keep them out of cards."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/jklthinking-retinue/assign-cards-to-ai-agents-on-one-board/",
 "md": "https://dedupedai.com/use-cases/jklthinking-retinue/assign-cards-to-ai-agents-on-one-board/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/jklthinking-retinue--assign-cards-to-ai-agents-on-one-board.json",
 "api_version": "v1"
}