---
title: "Set up Supcoflow"
description: "Instructions for a coding agent to set up the Supcoflow support chat in an app, and what only the person can do."
canonical: "https://supcoflow.dev/getting-started/"
---

# Set up Supcoflow

> Instructions for a coding agent. A person asked you to set up Supcoflow in the app in the current folder. People can read the same steps at https://supcoflow.dev/getting-started/.

Supcoflow gives this app a support chat: users report problems there, and an agent reads this codebase and turns each report into a technical issue in the GitHub repo.

## What you do

1. Install the skill: `npx skills add supcoflow/skills`
2. Run `/supcoflow go` with it. If the skill doesn't load in this session, tell the person to restart you and type `/supcoflow go` themselves.

## What only the person can do

When you get to one of these steps, tell the person what to do and wait:

- Sign in at https://app.supcoflow.dev when the browser opens. Signing in with GitHub creates the account right away.
- Approve the Supcoflow GitHub App on this repo.
- As soon as the project exists, open its Agents tab at https://app.supcoflow.dev and add their own AI Gateway key and an approved model for the chat and the triage agent. Each project pays for its own AI.
- Answer the setup questions.

Never ask the person for an AI key, and never accept one pasted into this conversation: it goes in the console, never through you.

## Requirements

- A GitHub repository for your app.
- A web app. Tested with Next.js (App Router).
- A coding agent with skills. Tested with Claude Code. Other agents that load skills (Codex, Cursor…) should work but aren't tested yet.
- A Vercel account, for the AI Gateway key.

## Reference

- Skill: https://github.com/supcoflow/skills (version 0.5.0)
- Terminal the skill drives: `supcoflow` 0.10.1 on npm, https://www.npmjs.com/package/supcoflow. `npx supcoflow@0.10.1 describe --json` lists its commands.
- Console: https://app.supcoflow.dev
- About Supcoflow: https://supcoflow.dev/index.md