Guidance for the reopt command-line tool, which is a text-based program for running reopt tasks from a terminal. It covers login, credentials, global options, security rules, and exit codes.

Use it before running reopt commands, checking login status, configuring Brandapp credentials, or writing continuous-integration scripts.

It helps an agent use the correct live commands and handle authentication or automated runs without relying on outdated documentation.

reopt-cli — Skill for Claude Code and Codex by reopt-ai

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add reopt-ai/reopt-skills --skill reopt-cli

Clone the repo

git clone --depth 1 https://github.com/reopt-ai/reopt-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/reopt-ai/reopt-skills/reopt-cli/github.svg)](https://agentmods.dev/skills/reopt-ai/reopt-skills/reopt-cli)

Your own site

<a href="https://agentmods.dev/skills/reopt-ai/reopt-skills/reopt-cli"><img src="https://agentmods.dev/badge/skills/reopt-ai/reopt-skills/reopt-cli/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/reopt-ai/reopt-skills/reopt-cli"><img src="https://agentmods.dev/badge/skills/reopt-ai/reopt-skills/reopt-cli.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 56 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 2,547 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00056	$0.02547
Opus 5	$0.00028	$0.01273
Sonnet 5	$0.00011	$0.00509
Haiku 4.5	$0.00006	$0.00255

Measured 4d ago against content hash 3a2c2f1ef861, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

reopt-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/reopt-cli/SKILL.md · 100 lines

How it starts

The opening of the file, as written. The whole thing — 100 lines — stays where its author put it; the contents beside it link to each section on GitHub.

reopt CLI

This is NOT the reopt CLI you know. Run reopt --help / reopt <cmd> --help for the live command tree. The CLI ships no dist/docs/; when narrative context is needed, locate the README.md from the actual CLI package installation or source checkout instead of assuming a local node_modules path.

When to apply

Any reopt CLI command.
Confirming login state, writing CI/CD steps around reopt, scripting Brandapp OAuth credentials.
Load before reopt-brandapp and reopt-eav.

Step 1 — Pin agent rules into AGENTS.md / CLAUDE.md

Source: the CLI's own agent-rules file once it ships one (@reopt-ai/cli does not, as of 0.7.0 — its skills/ bundle is a different thing, see Step 4). Fallback: agent-rules.md bundled with this skill. Wrap content between:

<!-- BEGIN:reopt/cli-agent-rules -->
…content from source…
<!-- END:reopt/cli-agent-rules -->

Idempotent: replace only between markers. This same block is shared by reopt-brandapp and reopt-eav — those skills will skip the step if the block is already present.

Step 2 — Auth (consumer-side credentials; CLI docs cover usage)

The CLI has three credential systems:

User session — reopt login / reopt status / reopt logout. Tokens live in ~/.reopt/auth.json. Session auto-refreshes inside the Better Auth extension window; do not over-engineer retry loops in CI.
Brandapp OAuth credentials — BRANDAPP_CLIENT_ID / BRANDAPP_CLIENT_SECRET env vars, or reopt brandapp link interactively. Stored in ~/.reopt/credentials.json + .reopt.json (project root).
Service token (CI/CD) — reopt token mint --ttl 15m --scope eav:migrate,eav:read prints a short-lived, scoped JWT for headless pipelines; capture with export BRANDAPP_CLIENT_TOKEN=$(reopt token mint --quiet). Pass to the SDK as a Bearer token — never ship a clientSecret where a scoped token works.

Run reopt status (or reopt status --ping) before any mutating operation. If auth: not logged in, run reopt login first.

Read the full file on GitHub · 100 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

4d ago Changed 3a2c2f1ef861
9d ago First seen · 100 lines · 56 tokens per session scan A 56ec66f52e4d

Subscribe to this mod's changes

reopt-cli is a skill published in the GitHub repository reopt-ai/reopt-skills (1 stars, last pushed 4d ago), licensed MIT. It adds 56 tokens to every session and 2,547 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Claude Code agent-skills ai-agents codex cursor skills

test-driven-development

Drives development with tests using the red-green-refactor loop. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.

addyosmani/agent-skills · 57 tokens

documentation-and-adrs

Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.

addyosmani/agent-skills · 58 tokens

idea-refine

Refines raw ideas into sharp, actionable concepts through structured divergent and convergent thinking. Use when an idea is still vague, when you need to stress-test assumptions before committing to a plan, or when you want to expand options before converging on one. Triggers on "ideate", "refine this idea", or…

addyosmani/agent-skills · 75 tokens

chinese-git-workflow

A reference for configuring Git with Chinese code-hosting services such as Gitee, Coding.net, GitLab China, and CNB, including SSH, HTTPS, credentials, CI, and repository mirroring.

jnMetaCode/superpowers-zh · 69 tokens

chinese-documentation

A Chinese technical-documentation style guide covering spacing, punctuation, numbers, terminology, and links when Chinese and English appear together.

jnMetaCode/superpowers-zh · 62 tokens

skillshare-implement-feature

Implement a feature from a spec file or description using TDD workflow. Use this skill whenever the user asks to: add a new CLI command, implement a feature from a spec, build new functionality, add a flag, create a new internal package, or write Go code for skillshare. This skill enforces test-first development…

runkids/skillshare · 114 tokens