PostgresAI CLI

Reference

• PostgresAI CLI reference (postgresai)

Install (optional)

You can run postgresai commands without installing, using npx or bunx. If you prefer to install it globally:

npm

npm install -g postgresai

Homebrew (macOS)

brew tap postgres-ai/tap https://gitlab.com/postgres-ai/homebrew-tap.git
brew install postgresai

Authenticate

Authenticate via browser and store the API key locally:

Installed CLI

postgresai login

npx

npx postgresai@latest login

bunx

bunx postgresai@latest login

In the browser, pick one organization, or All my organizations to get a global token that works across all of them. With a global token, add --org <alias> or --org-id <id> (or set PGAI_ORG) to organization-specific commands, and run postgresai orgs to list the organizations it can reach. See organization selection.

Install MCP (Cursor, Claude Code, Windsurf, Codex)

Install MCP integration for your AI coding tool:

Installed CLI

postgresai mcp install

npx

npx postgresai@latest mcp install

bunx

bunx postgresai@latest mcp install

Work with issues

List open issues (pass --status closed or --status all for the rest):

Installed CLI

postgresai issues list

npx

npx postgresai@latest issues list

bunx

bunx postgresai@latest issues list

View a specific issue:

Installed CLI

postgresai issues view <issue_id>

npx

npx postgresai@latest issues view <issue_id>

bunx

bunx postgresai@latest issues view <issue_id>

Post a comment:

Installed CLI

postgresai issues post-comment <issue_id> "<comment>"

npx

npx postgresai@latest issues post-comment <issue_id> "<comment>"

bunx

bunx postgresai@latest issues post-comment <issue_id> "<comment>"