Command Line Interface

Run RepoShift directly from your terminal. No URL needed inside a git repo.

Run directly (no install)

$npx reposhift audit

Or install globally

$npm install -g reposhift

Requires Node.js 18+ and an ANTHROPIC_API_KEY environment variable.

From inside a git repo

$reposhift audit

Specify a repo

$reposhift audit --repo=owner/repo

Detailed output

$reposhift audit --verbose

Remediation plan only

$npx reposhift audit --remediation

Full documentation kit

$npx reposhift audit --generate

Specific tools

$npx reposhift audit --generate --tools=claude,cursor

Output to a directory

$npx reposhift audit --generate --out=./docs

Flag	Description
`--repo=<url>`	Repository URL (auto-detected from git remote if omitted)
`--token=<pat>`	Personal Access Token for private repos
`--api-key=<key>`	Anthropic API key (alternative to env var)
`--json`	Output raw JSON instead of formatted report
`--verbose`	Show full finding descriptions and suggestions in report
`--categories=<list>`	Comma-separated categories to analyze (default: all 7)
`--remediation`	Generate only the REMEDIATION-PLAN.md (1 API call, fast)
`--generate`	Generate full AI documentation kit (ai/ directory + tool wrappers)
`--tools=<list>`	AI tools: claude, cursor, copilot, windsurf, codex, gemini
`--mode=<mode>`	Generation mode: full (default), missing (skip existing), update (improve existing)
`--out=<dir>`	Output directory for generated files

ANTHROPIC_API_KEY — Required. Claude API key.

GITHUB_TOKEN — Optional. GitHub PAT for private repos.

AZURE_DEVOPS_TOKEN — Optional. Azure DevOps PAT.

GitHub: https://github.com/owner/repo or owner/repo

Azure DevOps: https://dev.azure.com/org/project/_git/repo