agentconnect-setup

name

agentconnect-setup

description

Guide users through installing, configuring, and verifying the complete self-hosted AgentConnect OSS stack as an interactive tutorial. Use for Docker Compose setup, local no-auth evaluation, the bundled local Logto overlay, Logto Cloud authentication, Cloudflare Tunnel or reverse-proxy exposure, custom production domains, initial administrator bootstrap, daemon connection, deployment Google/Slack/GitHub Apps, public URLs, startup options, upgrades, or setup troubleshooting.

Set Up AgentConnect

Guide the user one checkpoint at a time. Select one deployment mode, load only its relevant references, verify each checkpoint from evidence, and keep a short progress checklist throughout the tutorial.

Establish the session

1. Determine the AgentConnect checkout or deployment directory. Prefer the current directory when it contains compose.yaml; otherwise ask for or locate the checkout.
2. Ask whether access is loopback-only, LAN-only, or through stable public domains using Cloudflare Tunnel or another reverse proxy. Never assume localhost. If anything is externally reachable, read references/network-topology.md and collect the final topology before continuing.
3. Determine the target mode:
   • no-auth: loopback-only local evaluation;
   • local-logto: local evaluation with the bundled Logto OSS overlay;
   • cloud-logto: a locally or single-hosted Compose stack using Logto Cloud.
4. Determine whether the user wants only the core stack or also Google, GitHub, Slack, a daemon, and production hardening.
5. Read references/deployment-modes.md plus references/local-logto.md or references/cloud-logto.md only when that mode is selected. Read references/integrations.md only for requested providers. Read for upgrades, reset, remote-daemon networking, or troubleshooting.