What happens when I run this command?

npx -y githits@latest init

The installer performs a short, interactive setup. It detects supported coding agents on your machine, guides you through authentication, and configures the ones you choose — nothing is modified until you confirm. Authenticating also creates your GitHits account if you don't have one yet, so this command is the sign-up flow too.

  1. Detect installed coding agents

    GitHits looks for supported AI coding tools already installed on your machine, such as Claude Code, Cursor, VS Code, Windsurf, and others. Nothing is installed at this stage.

  2. Choose what to configure

    You'll see the agents that were detected and can choose which ones should use GitHits. You can also choose whether the configuration applies only to the current project or to your user account. Nothing is modified until you confirm.

  3. Sign in / Sign up

    The installer opens your browser to sign in with GitHub — or to create your GitHits account on the spot if it's your first time. GitHits does not request access to your private repositories.

  4. Configure your selected agent

    The installer writes the required MCP configuration so your selected coding agents can use GitHits. No source code is uploaded, and no project files are modified unless you selected a project-level installation.

  5. Verify everything is ready

    The installer checks that the configuration is valid and lets you know when setup is complete.

GitHits gives AI coding agents access to real open-source examples, version-aware dependency source code, docs, and package metadata.

The installer detects the coding agents you already use

  • Codex
  • Claude
  • Cursor
  • VS Code
  • Copilot
  • Cline
  • Windsurf
  • OpenCode
  • Antigravity
  • Pi
  • Hermes

What the installer does not do

  • It does not read your source code.

  • It does not upload your repository.

  • It does not access your private GitHub repositories.

  • It does not modify your code.

  • It does not configure agents you didn't select.

Prefer to review everything first?

We believe developer tools should be transparent. Before running the installer, you can inspect the source, review the package, or follow the manual guide for your preferred coding agent.

Manual installation

Don't want to use the installer? GitHits can also be configured by hand for Claude Code, Cursor, VS Code, Windsurf, Continue, Cline, and OpenCode — follow the manual installation guide to copy the configuration for your coding agent.

Why use npx?

npx downloads and runs a package without requiring a permanent global installation. It is commonly used to distribute installers and project scaffolding tools throughout the JavaScript ecosystem. If you prefer not to run the installer, manual setup instructions are available above.

What's next?

Once configured, your coding agent can use GitHits to:

Get started

Install GitHits in one command

All from inside your existing coding workflow.

Read the docs
npx -y githits@latest init