DevImpact CLI

The DevImpact CLI securely connects your local GitHub activity to the DevImpact dashboard. It uses your local GitHub authentication (via the GitHub CLI) and only accesses the repositories you explicitly provide.

Prerequisites

Before installing, make sure you have: • Node 18+ • GitHub CLI (gh) installed and authenticated gh auth status

Installation

Install globally from npm

npm install -g @devimpact/cli

Verify installation

devimpact --version

Getting Started

1. Go to your DevImpact account and generate a CLI token.
2. Run:

devimpact init --cli-token <YOUR_CLI_TOKEN>

This securely links your CLI to your DevImpact account. The token is hashed locally and never stored in plain text.

Syncing Activity

Use the sync command to fetch GitHub pull request data and push it to your DevImpact account:

devimpact sync --repo owner/repo

You can provide multiple repositories

devimpact sync --repo org/frontend --repo org/api --repo org/mobile

If you use the same repos regularly, the CLI will remember them.

Permissions and privacy

The CLI uses your local GitHub CLI authentication, so DevImpact never sees your PAT or OAuth token.

When you run devimpact sync:

1. It uses your existing gh auth session to call gh api on your machine.
2. It only accesses the repos you explicitly pass
3. It fetches metadata about your PRs, reviews, commits, and files for the repos you specify.
4. It strips diffs, commit messages, and code blocks from data.
5. It sends a sanitized JSON payload to the DevImpact backend to power your personal dashboard.

No other GitHub data is accessed.

👉 For a detailed list of APIs and fields, see DATA & SECURITY.

You can inspect or delete your local DevImpact config at:

~/.config/devimpact/config.json

Uninstall

To remove the CLI:

npm uninstall -g @devimpact/cli

License

MIT