# Reopt Brandapp

> Brandapp linking, listing, doctor checks, terms management, project scaffolding (`init`), the in-memory dev server, seed data, and sandbox environments for the reopt CLI. Use when a task involves `reopt brandapp list`, `link`, `unlink`, `doctor`, `term list`, `init`, `dev`, `seed`, or `env`.

- **Type:** Skill
- **Install:** `agentstack add skill-reopt-ai-reopt-skills-reopt-brandapp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [reopt-ai](https://agentstack.voostack.com/s/reopt-ai)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [reopt-ai](https://github.com/reopt-ai)
- **Source:** https://github.com/reopt-ai/reopt-skills/tree/main/skills/reopt-brandapp
- **Website:** https://skills.sh/reopt-ai/reopt-skills

## Install

```sh
agentstack add skill-reopt-ai-reopt-skills-reopt-brandapp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# reopt Brandapp

> This is NOT the reopt CLI you know. Run `reopt brandapp --help` / `reopt brandapp  --help` for the live command tree. Read `node_modules/@reopt-ai/cli/README.md` § Commands for narrative guides (the CLI ships no `dist/docs/`).

## When to apply

- listing accessible brandapps
- linking / unlinking a project directory
- repairing stale links with `doctor`
- inspecting published terms
- scaffolding BrandApp dev files (`init`)
- running the offline in-memory dev server (`dev`, `seed`)
- managing sandbox cloud environments (`env list/create/use/destroy`)

Load `reopt-cli` first. Its agent-rules block (``) covers this skill too — if `reopt-cli` already pinned it, skip Step 1.

## Step 1 — Pin agent rules (only if `reopt-cli` hasn't already)

Same source/fallback/marker as `reopt-cli`. If the marker block is already present in AGENTS.md/CLAUDE.md, do nothing here.

## Step 2 — Command map (refer to `--help` for flags)

| Command | Purpose | Needs login | Needs link | Status |
|---|---|---|---|---|
| `brandapp list` | List accessible brandapps | ✓ | – | stable |
| `brandapp link` | Link current dir to a brandapp | ✓ | – | stable |
| `brandapp unlink` | Remove the current dir link | – | ✓ | stable |
| `brandapp doctor` | Repair stale links / missing creds | ✓ | ✓ | stable |
| `brandapp term list` | List brandapp terms | ✓ | ✓ | stable |
| `brandapp init` | Scaffold dev-mode files (see below) | – | – | stable |
| `brandapp dev` | Offline EAV/Auth/AI/Files server | – | – | experimental |
| `brandapp seed` | Apply seed data to dev server | – | – | stable |
| `brandapp env list/create/use/destroy` | Sandbox cloud envs | ✓ | ✓ | experimental |

Term types: `termsOfService`, `privacyPolicy`, `marketingConsent`, `custom`.

## Step 3 — `init` file map (consumer project, not module docs)

`reopt brandapp init` is a **dev-environment** scaffold — not the SDK app code. It only adds:

| File | When | Purpose |
|---|---|---|
| `.env.development` | always | `REOPT_DEV_MODE=true` + Better Auth placeholders |
| `reopt.seed.ts` | always | seed-data template |
| `lib/dev-server.ts` | Next.js only | `startDevServer()` wrapping `@reopt-ai/brandapp-sdk/dev` |
| `instrumentation.ts` | Next.js only | invokes `startDevServer()` when `REOPT_DEV_MODE=true` |
| `package.json scripts.dev:local` | Next.js only | `REOPT_DEV_MODE=true next dev` |
| `.gitignore` | always | appends `.reopt/` |

Detection: presence of `next` in `package.json`. Non-Next projects get only `.env.development` + `reopt.seed.ts` + `.gitignore` and must wire `startDevServer()` manually.

`init` does **not** create `.env.local`, `lib/sdk.ts`, `lib/auth.ts`, auth route handler, or webhook files, and does not clean legacy package-registry overrides — those belong to `brandapp-sdk-install`. The two skills are complementary; run `init` first, then `brandapp-sdk-install` for the SDK app code.

## Step 4 — Route to docs

| Task signal | Read |
|---|---|
| Flag-level reference for every subcommand | `reopt brandapp  --help` |
| Dev-server protocol, persistence, AI proxy | `@reopt-ai/brandapp-sdk/docs/dev-server.md` |
| Sandbox env lifecycle, TTL, AI limits | `reopt brandapp env --help` |
| Term schema | `reopt brandapp term --help` |

## Operating notes

- In a monorepo, `.reopt.json` is resolved by walking upward from the current dir.
- Run `reopt brandapp doctor` before CI jobs that depend on linked brandapps.
- `brandapp link` has no `--dry-run`; use `brandapp list --json` first if you need a preview.
- `brandapp env use` overwrites `.env.local` keys for `BRANDAPP_CLIENT_ID` / `BRANDAPP_CLIENT_SECRET` / `BRANDAPP_ID` (v2.0 namespace). Run it from the project that should target the sandbox.
- `dev`, `env *`, and `eav migrate *` are flagged experimental — surface that label when recommending so users know the API may shift.
- `init` is non-destructive without `--force`; warn before passing `--force` over an existing scaffold.

## Safety

- Inherit all rules from `reopt-cli` (no hardcoded credentials, no `~/.reopt/` commits, no credential printing).
- `brandapp env destroy` is irreversible — confirm `--force` is intentional.
- `brandapp seed --reset` wipes existing rows; only run on disposable environments.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [reopt-ai](https://github.com/reopt-ai)
- **Source:** [reopt-ai/reopt-skills](https://github.com/reopt-ai/reopt-skills)
- **License:** MIT
- **Homepage:** https://skills.sh/reopt-ai/reopt-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-reopt-ai-reopt-skills-reopt-brandapp
- Seller: https://agentstack.voostack.com/s/reopt-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.