@suavetech/cli

AI-powered agentic setup CLI. Scaffolds CLAUDE.md, AGENTS.md, and related files for AI-assisted coding workflows — so agents like Claude, Cursor, and Codex have what they need from day one.

Install

pnpm add -g @suavetech/cli
# or
npx @suavetech/cli setup

Quickstart

export ANTHROPIC_API_KEY=sk-ant-...

suave setup              # scaffold agentic files in the current directory
suave audit              # check which agentic files exist
suave create my-project  # new directory + full setup

Commands

| Command | Description | | --------------------- | -------------------------------------------------------- | | suave setup | Save your API key and see available commands. | | suave create [name] | Interactive flow. Asks about your project, calls an LLM, | | | writes CLAUDE.md, AGENTS.md, CHANGELOG.md, | | | .claude/settings.json, .agents/config.json. | | suave audit [path] | Reports which agentic files exist. Exits non-zero if a | | | required file is missing. |

Flags

• --dry-run — show what would be written without writing.
• --yes, -y — skip confirmation prompts.
• --verbose — print the meta-prompt and streamed LLM response.

Configuration

Create .suave/config.json in your project to override the audit list or model:

{
  "model": "claude-sonnet-4-6",
  "agenticFiles": [
    { "type": "file", "path": "CLAUDE.md", "label": "Claude prompt", "required": true },
    { "type": "dir",  "path": ".cursor",   "label": "Cursor rules" }
  ]
}

Environment

• ANTHROPIC_API_KEY — default provider key.
• SUAVE_API_KEY — overrides ANTHROPIC_API_KEY if set.

Development

pnpm install
pnpm dev          # watch build
pnpm build        # emit dist/index.js
pnpm start setup  # run the built CLI

License

MIT