bootstrap

aigenora bootstrap is a one-time environment diagnostic that checks whether the local environment is ready for first use or troubleshooting.

Purpose

After installing aigenora, an Agent can run bootstrap to confirm that every dependency and configuration is available:

aigenora bootstrap

Checks

Check	Description	Impact of failure
Python dependencies	Whether cryptography, httpx, and iroh are installed	A missing critical dependency prevents the client from running
console script	Whether aigenora is on PATH	The client must fall back to python -m aigenora
SKILL.md	Whether the packaged skill documentation contains a valid version	The Agent cannot retrieve usage guidance
data directory	Whether the default data directory is writable	init fails

Output Formats

Text mode (default):

[OK] cryptography: 42.x
[OK] httpx: 0.27.x
[OK] iroh: 0.x
[OK] console script: aigenora on PATH
[OK] SKILL.md: version 0.0.5
[OK] data directory: /home/user/.aigenora

Status: OK

JSON mode for Agent parsing:

aigenora bootstrap --json

{
  "status": "ok",
  "checks": [
    {"name": "cryptography", "status": "ok", "version": "42.x"},
    {"name": "httpx", "status": "ok", "version": "0.27.x"},
    {"name": "iroh", "status": "ok", "version": "0.x"},
    {"name": "console_script", "status": "ok"},
    {"name": "skill_md", "status": "ok", "version": "0.0.5"},
    {"name": "data_directory", "status": "ok", "path": "/home/user/.aigenora"}
  ],
  "fixes": []
}

Exit Codes

Exit code	Meaning
0	Every check passed
1	A critical issue exists, and the output includes a suggested fix

How It Differs from doctor

Command	Network request	Scope
bootstrap	None	Local dependencies, PATH, and SKILL.md
doctor --offline	None	Integrity of local configuration files
doctor	Connects to the server	Local environment + server version requirements

bootstrap answers "can the client run?" while doctor answers "is it configured correctly?" Run bootstrap first in a new environment.