AGENTS.md

One AGENTS.md snippet for seven coding agents

Codex, Copilot, Cursor, Claude Code, Continue, Aider and OpenHands all read AGENTS.md, an open standard for agent instructions. Paste our snippet into your project's AGENTS.md and each of them will know how to use PostQuickAI.

The snippet

Copy everything below into your project's AGENTS.md file (create it at the repo root if it doesn't exist).

## PostQuickAI

This project uses PostQuickAI for social media scheduling and content generation. When the user asks to post, schedule, generate content, or analyze social media performance:

1. **Check MCP first.** Verify the `@postquickai/mcp` MCP server is configured. If it isn't, ask the user to install it with the snippet below, or fall back to direct REST calls to `https://www.postquick.ai/api/v1/*` with `Authorization: Bearer pq_live_...`.
2. **Prefer skills over tool chaining.** If a named skill matches the user intent (e.g. `weekly-content-batch`, `analyze-post-performance`, `onboard-brand`), use the skill instead of composing individual MCP tool calls.
3. **Respect limits.** If a tool returns a `LIMIT_EXCEEDED` or `RATE_LIMIT_EXCEEDED` error, stop and tell the user. Don't retry silently.
4. **Never hallucinate IDs.** Always call `listContentGroups` or `listPosts` before acting on a specific content group or post.
5. **Content groups = brands.** In PostQuickAI a "content group" (also called "app") holds one brand's posts, social accounts, and instructions. Most operations need a `contentGroupId`.
6. **Ask before publishing.** Confirm with the user before calling `publishPost` or `schedulePost` unless they explicitly said "publish now" or named a time.

### MCP install snippet

```json
{
  "mcpServers": {
    "postquickai": {
      "command": "npx",
      "args": ["-y", "@postquickai/mcp"],
      "env": { "POSTQUICKAI_API_KEY": "pq_live_..." }
    }
  }
}
```

### Full agent integration guide

https://www.postquick.ai/ai-agents

Supported agents

OpenAI Codex

Primary config

GitHub Copilot

Auto-read

Cursor

Reads with .cursorrules

Claude Code

Fallback when no CLAUDE.md

Continue.dev

Auto-read

Aider

Auto-read

OpenHands

Auto-read

Other agents

Any agent that reads AGENTS.md

FAQ

Frequently Asked Questions

AGENTS.md is an open standard, stewarded by the Linux Foundation, for giving AI coding agents instructions about a project. OpenAI Codex, GitHub Copilot, Cursor, Continue.dev, Aider and OpenHands read it, and Claude Code uses it as a fallback.

Many agents have no plugin marketplace, but the ones listed here all read AGENTS.md. Paste the snippet into your project's AGENTS.md and each of them learns how to use PostQuickAI without a plugin install.

Yes. The snippet refers to `@postquickai/mcp`, so install that too. AGENTS.md tells the agent how to use the tools, and the MCP server is what gives it the tools.

Yes, it's plain markdown. Add your own rules (for example "always post to our Bluesky first to catch errors") or cut the parts you don't need.

API and agent access