Quickstart

This guide walks you through creating a managed agent using the Novu CLI, connecting it to Slack, and sending your first message.

Prerequisites

• Node.js installed on your machine.
• A Novu account (you can create one during the setup flow).
• A Slack workspace where you can install apps.

Run the CLI

In your terminal, run:

npx novu connect

Create an agent

1. Choose where your agent runs. The CLI asks Where do you want the agent to run?, select an option, and then press Enter:

   • Demo credentials
   • Claude Managed Agents
   • AWS Claude Managed Agents

   For this quickstart, select Demo credentials.

2. Describe your agent. Type a description of what you want the agent to do and press Enter. For example:

   textCopy

   Create an engineering assistant agent that checks Linear and GitHub for open issues, pending PR reviews, and review requests. It summarizes what needs attention, flags blockers and stale tickets, and posts a short daily standup digest. It keeps responses concise and links back to the relevant Linear issue or GitHub pull request.
   

   Novu generates the agent for you, including its system prompt, tools, MCP servers, and skills based on your description.

3. Review and create the agent. The CLI shows the generated agent for you to review. You can adjust any of the following fields before confirming:

   • Name
   • Identifier
   • System prompt
   • Tools
   • MCP servers
   • Skills

If everything looks good, then select Create this agent and press Enter.

If you want to change the description and regenerate, then select Regenerate from description and repeat the previous step.

Connect Slack

The CLI prompts you: pick a channel to connect this agent to. Select Slack and press Enter.

Novu asks you to paste a Slack App Configuration Token. To get one:

1. Open https://api.slack.com/apps.
2. Scroll to the bottom of the page.
3. Under App Configuration Tokens, click Generate Token.
4. Copy the access token, it starts with xoxe.xoxp-.
5. Paste the token into the terminal and press Enter. <Note> The CLI sends the token to your Novu account once to create the Slack app, then discards it; the token isn't stored. </Note>
6. Add the app to your workspace. After pasting the token, the CLI prompts you to add the app to your Slack workspace. Press Enter and follow the link to install the bot.

Once installed, your agent is live and listening for messages in Slack.

Send a message

Open Slack, where you see a message from your agent. Send it a direct message to get started. The agent then prompts you to connect your Linear and GitHub MCP servers; once you do, your agent is ready.

You can also add and interact with the agent in any channel in the workspace.

To manage your agent, add more channels, or view conversations from the Connect dashboard, create a Novu account at connect.novu.co.

<Prompt description="Copy an example agent description" icon="plug" actions={["copy", "cursor"]}> Create an engineering assistant agent that checks Linear and GitHub for open issues, pending PR reviews, and review requests. It summarizes what needs attention, flags blockers and stale tickets, and posts a short daily standup digest. It keeps responses concise and links back to the relevant Linear issue or GitHub pull request.

Use the Novu CLI (npx novu connect) or the Novu dashboard to create this managed agent. Connect Slack as the first channel.

Reference: https://docs.novu.co/agents/managed-agent/quickstart </Prompt>

Next steps