Quickstart: Cursor

This guide takes you from nothing installed to asking Cursor to check your Slack messages. Every step shows you exactly what to type and what you should see.

Prerequisites

• Python 3.11+ — check with python3 --version
• Cursor — installed and working (cursor.com)
• A Slack workspace (or any account you want to connect — Google works too)

Step 1: Install supyagent

pip install supyagent

Verify it worked:

supyagent --version

supyagent v0.6.2

Step 2: Connect your account

supyagent connect

╭──────────────────────────────────────╮
│                                      │
│   Your code:  ABCD1234               │
│                                      │
╰──────────────────────────────────────╯

Opening browser to https://app.supyagent.com/device...

Waiting for authorization...

Your browser opens. If you haven't signed up yet, create an account at supyagent.com and connect Slack (or any other integration). Then approve the device code.

Back in your terminal:

✓ Connected!

Connected Integrations
┏━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Provider ┃ Services                          ┃
┡━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ slack    │ general                           │
│ google   │ gmail, calendar, drive            │
└──────────┴───────────────────────────────────┘

Step 3: Generate skills

Navigate to your Cursor project and generate skill files:

cd ~/my-project
supyagent skills generate

Detected AI tool folders:

  1. Cursor  (.cursor/skills/)

Select folders (comma-separated numbers, or 'a' for all): 1

✓ Generated 4 skills (17 tools) in 1 location(s)
  .cursor/skills/
    supy-cloud-gmail/SKILL.md
    supy-cloud-calendar/SKILL.md
    supy-cloud-drive/SKILL.md
    supy-cloud-slack/SKILL.md

Step 4: Verify the generated files

Check that Cursor can see the skill files:

ls .cursor/skills/

supy-cloud-calendar/  supy-cloud-drive/  supy-cloud-gmail/  supy-cloud-slack/

Each folder contains a SKILL.md that Cursor reads automatically.

Step 5: Ask Cursor to use your integrations

Open Cursor in your project. In the AI chat (Cmd+L or Ctrl+L), try:

Check my Slack messages in #general

Cursor will:

1. Read the skill files in .cursor/skills/
2. Recognize that it can use supyagent service run slack_get_messages
3. Run the command in the terminal
4. Show you a summary of recent messages

More things to try:

What unread emails do I have?

Create a calendar event for "Team Lunch" tomorrow at noon

Send a Slack message to #engineering saying the deploy is complete

What's happening behind the scenes

When you ask Cursor about Slack, here's the flow:

1. Cursor reads .cursor/skills/supy-cloud-slack/SKILL.md
2. It sees the available tools and how to call them
3. It runs supyagent service run slack_get_messages '{"channel": "#general"}' in the integrated terminal
4. The CLI authenticates with your stored API key and calls the Supyagent API
5. The API uses your connected Slack OAuth token to call the Slack API
6. JSON results come back
7. Cursor presents the information in natural language

Troubleshooting

Cursor doesn't recognize the skills

Make sure the .cursor/skills/ directory exists in your project root:

ls -la .cursor/skills/

If it's empty, run supyagent skills generate --output .cursor/skills.

supyagent: command not found when Cursor runs the command

Cursor's integrated terminal may not have the same PATH as your regular terminal. Try installing supyagent globally:

pipx install supyagent

Or verify the path and add it to your shell profile:

which supyagent
# Add the directory to your PATH in ~/.zshrc or ~/.bashrc

Tool calls fail with authentication errors

Check your connection status:

supyagent status

If disconnected, run supyagent connect to re-authenticate.

Need to add more integrations

1. Go to supyagent.com and connect new integrations
2. Regenerate skill files:

supyagent skills generate --all