Archive Labs CLI

Archive Labs CLI is a terminal client for Archive. It signs in, reads repository state, runs sync and checks, and supports text or JSON output.

Install

npm install -g archive-labs
archive

No global install:

npx archive-labs

Commands

Auth and setup

• archive init Set the API and app targets for this workspace.
• archive login Sign in and store credentials for later commands.
• archive auth login Alias for browser-based sign-in from onboarding flows.
• archive logout Remove stored credentials from this machine.

Repository checks

• archive status Show repository health, readiness, and missing signals.
• archive sync Refresh the repository index and derived metadata.
• archive check Run the default check for the current context.
• archive check pr <number> Review a pull request for merge readiness, impact, ownership, and blockers.
• archive check diff Review the current working tree before commit or push.
• archive events Review recent repository events.
• archive recent Show recently used commands.

Impact and release

• archive impact file <path> Show what a file change affects across services and downstream paths.
• archive impact diff Summarize the impact of the current working tree.
• archive release summarize <tag> Summarize what is included in a release tag.
• archive release risk <tag> Review release risk before shipping.
• archive ask <question> Query the codebase in natural language.
• archive why <path> Show file or folder context from history and evidence.

Utilities

• archive doctor Inspect local config, auth, and runtime state.
• archive ping Check API connectivity.
• archive help Show the command list and usage.
• archive version Print the installed CLI version.

Example usage:

archive login
archive status
archive sync
archive check pr 182 --repository acme/payments --ci --json --strict
archive impact diff --json
archive release risk v1.2.0

Output

Use --json when you need machine-readable output. Text output stays short and terminal-friendly.

Config

CLI config is stored under ~/.archive-labs/config.json.

Environment variables:

• ARCHIVE_TOKEN
• ARCHIVE_LABS_TOKEN
• ARCHIVE_GITHUB_TOKEN

Publish

npm pack
npm publish