cn-check

# cn check — Local AI Agent Checks

Run AI-powered code checks locally against your working tree changes using the Continue CLI. Each check is an agent (defined in markdown) that reviews your diff, identifies issues, and optionally suggests fixes as a patch.

## When to Use

- User asks to run AI checks on their code changes
- User wants to set up `cn check` in a project
- User needs to create custom check agents
- User wants to apply AI-suggested fixes locally
- User asks about Continue CI or agent-based code review

## Installation

### Prerequisites

- Node.js 18+
- A git repository with uncommitted or branched changes

### Install the CLI

```bash
npm install -g @continuedev/cli
```

### Authenticate (required for Hub checks, optional for local-only)

```bash
cn login
```

This opens a browser for authentication. After login, Hub-configured checks are available automatically.

## Usage

### Basic: Run all discovered checks

```bash
cn check
```

This auto-detects checks from three sources (in priority order):

1. Hub API — checks configured for your repo on continue.dev
2. Local agents — markdown files in `.continue/agents/*.md`

### Specify agents explicitly

```bash
# Run a single local agent
cn check --agent .continue/agents/security-review.md

# Run a Hub-published agent
cn check --agent myorg/code-style

# Run multiple agents
cn check --agent .continue/agents/security.md --agent .continue/agents/docs.md
```

### Compare against a specific base branch

```bash
cn check --base develop
```

Default: auto-detects `main` or `master`.

### Output formats

```bash
# JSON output (for CI pipelines or scripting)
cn check --format json

# Unified patch output (pipe to git apply)
cn check --patch | git apply

# Stop on first failure
cn check --fail-fast
```

### Auto-fix mode

```bash
cn check --fix
```

Runs all checks, then applies any suggested patches directly to the working tree. Patches that conflict are reported but skipped.

## Creating a Check Agent

Create a