@ofabriciolima/aiox-vault-install

Cloud installer for private AIOX agent and squad vault packages.

Current package version: 1.1.0.

Usage

Open a terminal in an AIOX project and run:

npx @ofabriciolima/aiox-vault-install

The default installer is interactive in Brazilian Portuguese. Use the arrow keys, press Enter, and choose:

• what to install
• current folder or another project path
• install mode/profile
• conflict behavior
• post-install sync/validation
• install now or simulate

List packages:

npx @ofabriciolima/aiox-vault-install list

Install Agent Forge:

npx @ofabriciolima/aiox-vault-install install --package-type agents --package-id agent-forge --profile full --merge --create-missing-surfaces --yes

Install only Codex surface:

npx @ofabriciolima/aiox-vault-install install --package-type agents --package-id agent-forge --profile codex-only --merge --create-missing-surfaces --yes

Dry-run with plan export:

npx @ofabriciolima/aiox-vault-install install --package-type agents --package-id agent-forge --profile full --merge --dry-run --export-plan install-plan.json

Private Vault Auth

This installer keeps the vault repository private. It can fetch package files with either:

• GitHub CLI: run gh auth login
• Environment token: set GITHUB_TOKEN with access to uzeninguem/aiox-agent-squad-vault

Commands

• install - interactive or flag-driven install.
• list - list agents/squads from the private vault registry.
• doctor - show auth and vault configuration health.

Install Flags

• --package-type agents|squads|both - Registry type to install from.
• --package-id <id> - Install one package by id.
• --all - Install all packages from the selected package type.
• --target <path> - Target AIOX project. Defaults to the current terminal folder.
• --profile full|codex-only|core-only|all-clis - Install profile.
• --merge - Use the recommended safe merge conflict policy.
• --backup - Backup and overwrite existing files.
• --force - Overwrite without backup.
• --conflict-policy merge|create-only|backup-and-overwrite|force-overwrite|skip-existing - Explicit conflict behavior.
• --create-missing-surfaces - Create selected CLI/IDE folders when missing.
• --allow-non-aiox-target - Allow install when .aiox-core is not present.
• --run-sync - Run package post-install sync/validation commands when available.
• --dry-run - Show the plan without writing files.
• --export-plan <path> - Write the install plan as JSON.
• --yes / -y - Skip final confirmation.

Profiles

• full - AIOX Core, Codex, supported CLI/IDE surfaces, and docs.
• codex-only - Only the local Codex skill/agent surface.
• core-only - Only canonical .aiox-core source files.
• all-clis - CLI/IDE surfaces without .aiox-core.

Interactive Notes

Profiles are the safest path for most installs. The default interactive flow hides surface-level details and maps simple choices to the right profile.

When a file already exists, choose Mesclar com seguranca for the safest default. The merge policy creates a backup, updates AIOX-MANAGED blocks when present, deep-merges JSON files, and preserves local text by appending missing package content into an audited AIOX-VAULT-MERGE section.

Conflict policies:

• merge - Recommended. Backup + managed-block merge + JSON deep merge + text preservation.
• create-only - Block when a target file already exists.
• backup-and-overwrite - Backup and overwrite.
• skip-existing - Leave existing files untouched.
• force-overwrite - Overwrite without backup.

Valid custom surfaces are: aiox-core, codex, claude, gemini, cursor, github-copilot, antigravity, kimi, docs.

Environment Overrides

• AIOX_VAULT_OWNER
• AIOX_VAULT_REPO
• AIOX_VAULT_REF
• AIOX_VAULT_LOCAL_ROOT for local testing/development

Publish

The package is configured as a public scoped npm package.

npm login
npm publish --access public

After publish, the command works from any AIOX project:

npx @ofabriciolima/aiox-vault-install