---
title: "CLI"
description: "Every agent-kit command and flag."
canonical_url: "https://razcue-agent-kit.vercel.app/en/reference/cli"
---
# CLI

> Every agent-kit command and flag.

Run with `npx @razcue/agent-kit <command>`.

## agent-kit init

Ask the setup questions and write the project (re-runnable).

```bash
agent-kit init [dir]
    --name <kebab>  --kind monorepo|site|existing|blank  --stack none|nuxt-supabase|nuxt-content-site  --apps web,app,docs
    --level technical|non-technical  --lang en|es  --method sdd-tdd|sdd  --commits conventional|none  --git pr|trunk|read-only
    --main <branch>  --marketplace github:<owner/repo>|<local path>  --yes (defaults, no prompts)
    --supabase-mcp <project-ref>   read-only Supabase MCP server in .mcp.json
    --qa-checklist true|false  --test-data true|false (Supabase only)  --test-prefix TEST_  --test-data-dir supabase/test-data
```

## agent-kit upgrade

New questions only + re-apply the agent layer + what's new.

```bash
agent-kit upgrade [dir] [--yes]
```

## agent-kit propose

Send an improvement idea to the kit.

```bash
agent-kit propose "<title>" [--kind skill|hook|…] [--body …]
```

## agent-kit uninstall

Remove what agent-kit added (backed up; your content stays).

```bash
agent-kit uninstall [dir] [--dry-run]
```

## agent-kit setup

Make global knowledge writable on this machine.

```bash
agent-kit setup [--home <agent-kit clone>]
```

## agent-kit doctor

Check a project's agent setup (--fix regenerates indexes and the board).

```bash
agent-kit doctor [dir] [--fix]
```

## agent-kit knowledge

Knowledge base tools.

```bash
agent-kit knowledge <paths|find|index|check> ...
```

## agent-kit scripts

Script registry.

```bash
agent-kit scripts <find|list|run|test|new|index|check> ...
```

## agent-kit tdd

TDD status and related-test runs.

```bash
agent-kit tdd <status|run> ...
```

## agent-kit work

Active work, board, scenario trace of a change.

```bash
agent-kit work <status|board|trace|new> ...
```

## agent-kit specs

Living specs: notation lint, next id, merge a change, trace.

```bash
agent-kit specs <lint|next|merge|trace|list> ...
```

## agent-kit qa

QA checklist from the living specs, QA runs, test-data fixture gaps.

```bash
agent-kit qa <sync|run|status|gaps> ...
```

## agent-kit preflight

Pre-merge checklist (exit 1 = block).

```bash
agent-kit preflight [base]
```

## agent-kit context

Tokens loaded every session + invisible skills.

```bash
agent-kit context [dir] [--budget N]
```

## agent-kit usage

Usage signals for a retro.

```bash
agent-kit usage [--days N]
```

## agent-kit commit

Conventional Commit helpers.

```bash
agent-kit commit draft [--staged] | check "<message>"
```


## Sitemap

See the full [sitemap](https://razcue-agent-kit.vercel.app/sitemap.md) for all pages.