> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/obra/superpowers/llms.txt
> Use this file to discover all available pages before exploring further.

# Install on Cursor

> Install Superpowers on Cursor Agent via the plugin marketplace

Install Superpowers on Cursor using the built-in plugin marketplace. Cursor provides a streamlined installation experience through the Agent chat interface.

## Prerequisites

* Cursor IDE installed and running
* Internet connection for marketplace access

## Installation Steps

<Steps>
  <Step title="Open Cursor Agent">
    Open the Cursor Agent chat interface:

    * Use keyboard shortcut: `Cmd+L` (Mac) or `Ctrl+L` (Windows/Linux)
    * Or click the Agent icon in the sidebar
  </Step>

  <Step title="Install from Marketplace">
    In the Agent chat, run the plugin installation command:

    ```text theme={null}
    /plugin-add superpowers
    ```

    Cursor will download and activate the plugin automatically.
  </Step>

  <Step title="Verify Installation">
    Start a new Agent session and confirm Superpowers is active:

    ```text theme={null}
    Do you have superpowers?
    ```

    The agent should confirm installation and describe available skills.
  </Step>
</Steps>

## What Gets Installed

The plugin includes:

* **Skills library** - All core Superpowers skills (brainstorming, TDD, debugging, collaboration)
* **Agents** - Pre-configured subagents for specialized tasks
* **Commands** - Workflow automation commands
* **Hooks** - Context-aware skill activation

## Verifying Skills Work

Test automatic skill activation:

<CodeGroup>
  ```text Design Phase theme={null}
  Let's design a new feature for user profiles
  ```

  ```text Implementation theme={null}
  I need to implement authentication middleware
  ```

  ```text Debugging theme={null}
  This API endpoint returns 500 errors randomly
  ```
</CodeGroup>

The agent should automatically invoke the appropriate skill (brainstorming, writing-plans, or systematic-debugging) based on context.

## Updating

Update to the latest version:

```text theme={null}
/plugin-update superpowers
```

<Note>
  Cursor may prompt you to restart the Agent after updates. This ensures all changes take effect.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Plugin installation fails">
    **Symptom:** Error when running `/plugin-add superpowers`

    **Solutions:**

    * Check your internet connection
    * Verify Cursor is up to date (Help → Check for Updates)
    * Try restarting Cursor IDE completely
    * Check Cursor documentation for current plugin syntax
  </Accordion>

  <Accordion title="Skills not loading automatically">
    **Symptom:** Agent doesn't use Superpowers workflows

    **Solutions:**

    * Start a fresh Agent session (`Cmd+L` / `Ctrl+L`)
    * Explicitly request a skill: "use the brainstorming skill"
    * Verify plugin is installed: check Cursor settings
    * Update the plugin: `/plugin-update superpowers`
  </Accordion>

  <Accordion title="Commands not recognized">
    **Symptom:** `/plugin-add` command not found

    **Solutions:**

    * Ensure you're in the Agent chat (not Composer or inline chat)
    * Update Cursor to the latest version
    * Check Cursor's plugin documentation for syntax changes
  </Accordion>

  <Accordion title="Agent behavior unchanged after install">
    **Symptom:** No difference in agent responses

    **Solutions:**

    * Restart the Agent session completely
    * Try a task that clearly triggers a skill (e.g., "help me debug this")
    * Check if plugin loaded: ask "what skills do you have?"
    * Reinstall: remove and add the plugin again
  </Accordion>
</AccordionGroup>

<Warning>
  Cursor Agent and Cursor Composer are different interfaces. Superpowers works best in the Agent chat interface.
</Warning>

## Uninstalling

To remove Superpowers from Cursor:

```text theme={null}
/plugin-remove superpowers
```

Restart the Agent session for changes to take effect.

## Platform-Specific Notes

### Cursor Composer vs Agent

Superpowers is designed for **Cursor Agent** (the chat interface). While it may work in Cursor Composer, the full workflow is optimized for Agent conversations.

### Workspace Context

Cursor Agent automatically provides workspace context to Superpowers skills. This means skills like `brainstorming` and `writing-plans` can reference your existing codebase structure.

## Next Steps

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/getting-started/quick-start">
    Learn the basic workflow
  </Card>

  <Card title="Skills Overview" icon="book" href="/skills/overview">
    Browse available skills
  </Card>

  <Card title="Create Skills" icon="pen" href="/customization/personal-skills">
    Build custom skills
  </Card>

  <Card title="Get Help" icon="question" href="/troubleshooting">
    Common issues and solutions
  </Card>
</CardGroup>