Skip to main content

How to work with Issues

PostgresAI generates daily issue reports with detected problems and recommended actions for your Postgres databases. This guide shows how to view, manage, and resolve issues.

Prerequisites​

  • A PostgresAI account with an active monitoring instance

View issues in PostgresAI Console​

Open PostgresAI Console and click Issues in the left sidebar to see all issue reports.

PostgresAI Console: Issues list with generated issue reports

Manage an issue​

Click an issue to open its details page. You can:

  • Assignees: assign the issue to a team member.
  • Status & labels: update status and labels as needed.
  • Resolve in Cursor: open the issue in Cursor to work through the recommended steps in your AI-assisted workflow.

PostgresAI Console: Issue details page with assignees, status, and the Resolve in Cursor action

Work with issues via CLI​

You can also manage issues using the PostgresAI CLI:

# List all issues
postgresai issues list

# View a specific issue
postgresai issues view <issue_id>

# Post a comment
postgresai issues post_comment <issue_id> "comment"

See PostgresAI CLI reference for all available commands.

Integrate with AI coding tools​

Issues can be resolved directly in AI coding tools that support MCP integration:

  1. Install MCP: postgresai mcp install
  2. Open the issue in your AI coding tool (Cursor, Claude Code, Windsurf, or Codex)
  3. Follow the AI-guided steps to resolve the issue

See How to install MCP for setup instructions.