Install the GovCon CLI

Install

govcon brings G2X, the intelligence layer for GovCon growth, to your terminal and scripts. You sign in with your G2X account in your browser, and results include links to the G2X records they come from.

GovCon CLI 0.3.4 is available on npm. You need Node.js 20.19.0 or later and a G2X account.

$ npm install -g govcon$ govcon --version

Or run it without installing:

$ npx govcon --help

Sign in

$ govcon login

govcon login opens your browser, and you sign in to G2X as you do on the web. govcon then keeps you signed in on this computer. govcon whoami shows the account you're signed in with, and govcon logout signs you out.

On a computer without a browser, such as over SSH:

$ govcon login --no-browser

It shows an address to open on any device. When you've signed in there, paste back the address your browser ends up on. Over SSH, or on a Linux computer without a display, govcon login does this on its own.

Five useful commands

Find open opportunities

Search open federal opportunities.

$ govcon opportunities "cloud migration" --naics 541512,541519 --limit 8

Search inside solicitation documents

Search opportunities by the text inside their documents: SAM, SLED, DIBBS, SBIR/STTR.

$ govcon documents-search "zero trust architecture" --source sam,sled

See who won similar work

Search federal contract awards.

$ govcon contracts "help desk" --filter naics=541512 --filter fiscal_year:=2025

Research a company

Find companies by name, UEI, or CAGE code.

$ govcon companies "Leidos"

See planned buys before they're posted

Search procurement forecasts: planned buys not yet solicited.

$ govcon forecasts "cloud hosting" --agency DHS,VA --fiscal-year 2027

Then govcon history <uei> shows a company's contracting portfolio, and govcon read prints a whole solicitation document. Every command has --help. Every command that reads from G2X accepts --json.

Use it from your agent

Connect G2X to Claude Code, Cursor, or Codex:

$ govcon mcp add claude$ govcon mcp add cursor$ govcon mcp add codex

govcon mcp add sets up Cursor for you, and prints the one command to run for Claude Code or Codex. Your agent then gets G2X's research tools, with your sign-in from govcon login. Use the CLI with coding agents has the details and the agent skill.

Keep going

• Commands: every command and option, grouped by the work it does.
• Use the CLI with coding agents: the local MCP server and the agent skill.