Skip to content

docs: scenario playbooks - #39

Merged
devin-ai-integration[bot] merged 5 commits into
mainfrom
devin/1791784243-playbooks
Oct 12, 2026
Merged

devin-ai-integration[bot] merged 5 commits into
mainfrom
devin/1791784243-playbooks

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds docs/playbooks/: step-by-step guides for common setups, with an index linked from the README, SETUP and AGENT_SETUP. Every playbook follows the same shape: Use this when → You'll need → Steps (per machine, human-only commands marked) → It worked if → If something goes wrong (symptom / cause / fix) → Next.

# Playbook
01 First group, two machines
02 Many devices at once (--count N)
03 Add a device later
04 One machine in several groups
05 Different networks (join --via, --peer, then repeater)
06 Self-host a repeater (serve, systemd/Docker, invite and URL-request enrollment)
07 Laptop away from home (repeater fallback, --relay-only)
08 Agents coordinating a test across machines (instructor/executor prompts)
09 Windows + omp
10 Coming with member removal/rekey
11 Troubleshooting

How the output lines were checked: the "It worked if" lines in 01–04 and 06 are quoted from real local runs, using temporary data dirs and loopback --via and repeater addresses. 05, 07, 09 and parts of 11 can't run on one Linux box (real multicast, off-LAN, Windows), so those quote strings from the source and installer instead.

Depends on #38: the 01–03 transcripts show via pc-a, which needs the --name fix in #38. Merge #38 first.

Corrections to existing docs: AGENT_SETUP listed group remove|rekey|admin as human-only commands, but they don't exist yet, so I removed them. SETUP now says that invites open an extra ephemeral TCP listener.

README: a top "Experimental" note (pre-1.0, commands, on-disk formats and wire protocol may change; no external security review). It matches the "Experimental" labels on the site (#33).

Link to Devin session: https://app.devin.ai/sessions/2e5afab1127347e783891657f1394118
Open in Devin Desktop: https://app.devin.ai/desktop/session/2e5afab1127347e783891657f1394118?variant=devin
Requested by: @DailenG

devin-ai-integration Bot and others added 3 commits October 12, 2026 06:11
Co-Authored-By: Dailen Gunter <daileng@gmail.com>
Co-Authored-By: Dailen Gunter <daileng@gmail.com>
Co-Authored-By: Dailen Gunter <daileng@gmail.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

@coderabbitai

coderabbitai Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: a4ef8ec3-e006-4d60-a272-733a210ae5cb

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Dailen Gunter <daileng@gmail.com>
devin-ai-integration[bot]

This comment was marked as resolved.

Co-Authored-By: Dailen Gunter <daileng@gmail.com>
@devin-ai-integration
devin-ai-integration Bot merged commit 5fb5af2 into main Oct 12, 2026
5 checks passed
@devin-ai-integration devin-ai-integration Bot mentioned this pull request Oct 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant