Document resumable agent self-setup

[dimavrem22]

Executive Summary

Documents a safe, resumable self-setup flow for an OpenCode agent using an identity assigned by a human.

• Inspects and executes the same downloaded installer artifact without opening the interactive setup wizard.
• Keeps credentials private while bootstrapping the assigned identity with the complete OpenCode configuration.
• Explains human-action recovery, error retry, and doctor verification.

Description

The README now provides an agent-executable installation and bootstrap sequence for an existing Inkbox identity. It quotes shell placeholders, keeps the credential out of command arguments and project files, and documents local owner-only credential persistence.

The guidance also explains each bootstrap result: preserve and resume the assigned identity after required human action, diagnose and retry errors with the same command, and verify configured state with inkbox-opencode doctor.

Reason

Agents need a complete unattended setup path that safely uses a human-assigned identity and can recover from interruptions without creating or selecting another identity.

Decisions

• Installer inspection: Download, display, and execute one temporary installer artifact so the reviewed content is exactly what runs.
• Identity recovery: Resume the same bootstrap command with the assigned identity after human actions or corrected errors so retries cannot silently change identity.

Testing

• OpenCode assigned-identity bootstrap guidance: The documented flow is expected to install without the wizard, preserve the assigned identity across retries, and finish with inkbox-opencode doctor verification; all README bash blocks passed bash -n parsing.
• npm test -- --run tests/cli/bootstrap.test.ts tests/cli/doctor.test.ts: 2 files and 20 tests passed.
• npm run typecheck: passed.
• npm run build: passed.
• bash -n install.sh: passed.
• git diff --check: passed.