Document safe agent self-setup

[dimavrem22]

Executive Summary

Documents a safe, complete self-setup flow for agents connecting an assigned Inkbox identity to Claude Code.

• Inspects and executes the same downloaded installer artifact with interactive setup disabled.
• Preserves the assigned identity and private credential handling across resumable bootstrap attempts.
• Explains human-action handoff, error recovery, and doctor verification.

Description

Expands the README's unattended bootstrap guidance into an agent-executable sequence. The installation example downloads the repository installer once, displays that exact artifact, executes it with --no-setup, and removes the temporary file on success or failure.

The guide supplies the complete host-specific bootstrap command with shell-safe placeholders, documents each JSON result state, and explains how to resume the same command after a requested human action or corrected error before verifying setup with inkbox-claude doctor.

Reason

Agents given an existing identity and credential need standalone guidance to install and configure the integration safely without switching identities or exposing reusable secrets.

Decisions

• Installer inspection: Display and execute one downloaded artifact so the reviewed script is the script that runs.
• Recovery behavior: Resume the identical bootstrap command after human action or error correction so partial progress and the assigned identity are preserved.
• Credential handling: Keep the credential out of command arguments, source control, project instructions, and persistent text.

Testing

• README self-setup behavior: the documented flow should inspect and execute the same installer artifact, preserve the assigned identity through resumable bootstrap, and finish with inkbox-claude doctor reporting the configured integration.
• python3 -m pytest -q tests/test_bootstrap.py tests/test_doctor.py: 5 passed.
• bash -n install.sh and bash install.sh --help: passed; the installer exposes --no-setup.
• python3 -m inkbox_claude.cli bootstrap --help and python3 -m inkbox_claude.cli doctor --help: passed; the documented commands and bootstrap flags are registered.
• All README bash blocks parsed successfully with bash -n.
• git diff --check: passed before and after rebasing onto origin/main.