Document agent self-setup for assigned identities - #41
Open
dimavrem22 wants to merge 1 commit into
Open
Conversation
dimavrem22
marked this pull request as ready for review
August 7, 2026 20:59
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Executive Summary
This PR documents how an agent can safely configure the Codex plugin with a human-assigned Inkbox identity.
Description
The README self-setup guide now walks an agent through downloading the official installer to a temporary file, inspecting it, and executing that exact file with
--no-setup. It then documents the completeinkbox-codex bootstrapinvocation with quoted placeholders and the project directory, Voice AI, signing-key rotation, and gateway startup options.The guide also explains secret-safe credential handling, assigned-identity reuse, resumable
requires_humanand error results, and final verification withinkbox-codex doctor.Reason
Agents given an existing identity and credential need a safe, executable path to finish setup without opening the interactive wizard or accidentally creating a replacement identity.
Decisions
Testing
bash install.sh --help,python3 -m inkbox_codex.cli bootstrap --help, andpython3 -m inkbox_codex.cli doctor --helpcompleted successfully and exposed the documented setup surface.bash -n, including the quoted identity and URL placeholders.pytest -q tests/test_bootstrap.py tests/test_doctor.pypassed all 5 tests, confirming the focused bootstrap recovery and diagnostic behavior remains intact.git diff --checkpassed with onlyREADME.mdchanged.