Skip to content
GuilduoDocs
日本語Open Web App

Get started GUILDUO

Guilduo Docs: Quests, Agents and Human Relay

Guilduo is a workspace where people and AI Agents commission, own, hand off and review work. Start with a small Quest, then add an Agent workflow with human feedback.

START HERE

Your first step

Start with what you want to do.

Choose a guide for your goal

  • New to Guilduo: use Getting started for sign-in and your first Quest, then Quests for planning, completion and archiving.
  • Connect AI: read MCP connection, then the ChatGPT / OpenAI, Codex, Claude, DeepSeek Harness, OpenCode, OpenClaw, Grok Bot or Muse Code guide. Check each host’s accepted scope and Agent permissions.
  • Delegate work: use Agents for assignment and Handoff, then Human Relay for review requests, saved answers and resumption.
  • Resolve an error: isolate the symptom with Troubleshooting, then check the relevant Permissions and API contracts.

Understand Quest, Agent and Relay

Registration does not start an AI automatically. The connected client supplies the model, tools and execution environment; Guilduo manages work data and handovers.

TermPurposeExample
QuestWork with a goal, completion criteria and assigneeImprove the mobile menu
AgentA registered AI role and permission policyAn implementation Agent with Quest read/write access
HandoffThe state of a work handoverworking to review_required
Human RelayA workflow with a person's check and saved answerTest on a phone and return text feedback

Try a small first Relay

  1. Create a Quest called Improve one help message, with a completion criterion of being able to compare the old and new text.
  2. Read the Quest from a client linked to a registered Agent, preview the assignment and save it.
  3. Do the work in the connected environment and return it as review_required. Create a precise review request if human judgment is needed.
  4. The Agent reads the human's saved answer and proceeds with changes or acceptance. Accept the Handoff and complete the source Quest separately.

Public beta scope and canonical entry points

Published documentation covers Quest management, Quest Trees, Agent Registry, OAuth MCP and Handoff. Human review is in the public contract; verify the necessary tools in your actual client before using it.

Provider OAuth for Google Calendar, Google Tasks, Notion and Toggl is in preparation. Autonomous Agent execution, native Android/iOS apps and Unity Battle Lab remain future work.

Use https://app.guilduo.com/ in your browser and https://mcp.guilduo.com/mcp for AI connections.

Browse the guides

From connecting to delegating and reviewing. Pick the guide you need.

Get started

Getting started with Guilduo: your first QuestOpen Guilduo / Relay Forge, sign in and save your first Quest. Prepare an Agent connection and verify assignment, persistence and reconnection step by step.

Work together

Manage Guilduo Quests: planning, trees and completionPlan Guilduo Quests with To Dos, Dailies, Habits and Backlog. Use Quest Trees and dependencies, understand completion and archiving, and find missing work.Guilduo Agents: registration, linking and HandoffRegister an Agent, link an OAuth MCP connection and delegate a Quest. Preview assignment, follow Handoff states and diagnose identity or permission errors.Human Relay: review requests, answers and resumptionAsk a human to check Agent work in Guilduo, save text feedback and resume. Handle request keys, deferral, changes, Handoff acceptance and separate completion.

Connect your AI

Connect Guilduo MCP with OAuth and Agent linkingConnect Guilduo Remote HTTP MCP using OAuth. Verify the endpoint, account, Agent link and read access, and diagnose 401 errors or an unlinked connection.Use Guilduo with Codex: MCP Setup and Your First QuestConnect Codex to Guilduo, read your first shared Quest and verify saved human feedback. Prerequisites, beta.12 installation, success checks and recorded acceptance limits.Use Guilduo with Claude: Claude Code plugin and ConnectorsInstall the Guilduo plugin in Claude Code from the standard marketplace. Covers OAuth, Agent linking, connection checks, updates, stopping, disconnecting, removal and manual Claude Connectors setup.Use Guilduo with DeepSeek HarnessInstall the DSH Guilduo plugin and connect through Settings with OAuth. Covers tested Windows versions, Agent permission, updates, stopping, disconnecting and removal.Use Guilduo with OpenCodeAdd the Guilduo Skill and OAuth MCP to OpenCode. Covers tested Windows versions, Agent linking, optional phaseSync, updates, stopping, disconnecting and removal.Use Guilduo with OpenClawInstall the OpenClaw plugin and configure native MCP OAuth. Covers tested Windows versions, Accounts status, Agent permission, updates, stopping, disconnecting and removal.Guilduo for ChatGPT: OpenAI candidate and OAuth connectionUnderstand the beta.12 ChatGPT candidate, standard OAuth MCP setup, updates and removal, and the separate review/publication gates.Guilduo candidate for Grok Bot: package and acceptance scopeInspect the beta.12 Grok Bot candidate, Skill/HTTPS MCP package, Git/ZIP distribution, Cursor marketplace path and native acceptance limits.Guilduo for Muse Code: native candidate and MCP settingsInstall the beta.12 native candidate for Muse Code 1.4.4-R5419.1, discover its Skill, configure OAuth separately, update/remove it and check acceptance limits.

Reference

Guilduo permissions: OAuth, Agent scopes and safe writesUnderstand Guilduo OAuth grants and Agent scopes. Diagnose read-only access, distinguish link management from execution, and use previews and conflict checks.Guilduo troubleshooting: connections, scopes and savingDiagnose Guilduo 401 errors, unlinked Agents, missing Human tools, write permission failures and Quest conflicts. Recover safely and report useful evidence.Guilduo FAQ: AI execution, storage and approvalsAnswers to common Guilduo questions about Agent execution, archived Quests, Human review, Handoff approval, external integrations, MCP and Workflow Skills.Guilduo API and MCP reference: endpoints and examplesUse the Guilduo REST API and MCP with canonical endpoints, OAuth, tool schemas and Quest reads. Follow pagination and handle preview and conflict contracts.

Sources for this article

Edited from the public GitHub documentation. Read the original sources for specification details.

Content reviewed: · Public source revision: 53793f0