Search docs
Docs searchInstall ArchPilot
Install ArchPilot
Install the VS Code extension or CLI, connect ArchPilot Cloud with an organization API token, and choose a manual or CI upload flow.
Use this page when you want to connect local validation to the Cloud workspace through the VS Code extension, CLI, API tokens, and CI upload.
Plan availability
Manual governance upload
Upload a validated snapshot from the CLI, extension, or Inspector when you want to publish a Cloud checkpoint.
Automatic CI-to-Cloud upload on main
Upload automatically from GitHub Actions after main-branch validation succeeds.
What the Install page covers
- VS Code extension setup for editor workflows
- CLI installation for terminal and CI workflows
- Cloud connection through organization API tokens
- Manual uploads from local validation
- CI-to-Cloud upload flow for paid plans
Install local tooling
Use the VS Code extension when developers want validation and findings review in the editor.
Use the CLI when validation needs to run in a terminal, script, or CI workflow.
Install the CLI:
npm install -g @archpilotlabs/archpilotConnect Cloud
- Open ArchPilot Cloud and select the organization workspace.
- Create an organization API token from Settings, API tokens.
- Run local validation with the extension or CLI.
- Upload the validated snapshot manually when you want it visible in Cloud.
- For paid plans, configure CI so main-branch validation can upload to Cloud automatically.
Manual upload:
archpilot governance upload --server https://api.archpilot.org --token <organization-api-token>Plan note
Manual uploads are available on all plans. CI-to-Cloud uploads are available on paid plans.
Use Repositories after upload to confirm repository posture, findings, inventory, and snapshot history.