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.

01

Your first Quest

Open Guilduo / Relay Forge, sign in and save your first Quest. Prepare an Agent connection and verify assignment, persistence and reconnection step by step.

Read the guide →02

Connect with MCP

Connect Guilduo Remote HTTP MCP using OAuth. Verify the endpoint, account, Agent link and read access, and diagnose 401 errors or an unlinked connection.

Read the guide →03

Ask a human to review

Ask a human to check Agent work in Guilduo, save text feedback and resume. Handle request keys, deferral, changes, Handoff acceptance and separate completion.

Read the guide →

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 an AI client: start with MCP connection, then Codex or Claude. Verify the linked Agent and permissions afterward.
  • 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.Connect Codex to Guilduo: MCP and Workflow SkillConnect Codex to Guilduo, verify Agent context and use Quests. Install the local Workflow Skill companion for an existing App and prepare a Human Relay.Connect Claude to Guilduo with OAuth MCPSet up Guilduo in Claude Connectors with OAuth. Link the correct Agent, read your first Quest, preview authorized writes and diagnose connection problems.

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: 5125178