Ack-AI

Acknowledge your AI-generated code before it hits production.

Ack-AI is a VS Code extension that enforces a "Human-in-the-Loop" workflow. It scans your source code for AI generation tags and highlights them with a warning until a human developer explicitly acknowledges ("acks") them.

Why Ack-AI?

AI coding assistants (Copilot, ChatGPT, Claude) are powerful, but they can introduce subtle bugs or security hallucinations. Ack-AI ensures that no AI-generated code remains in your codebase without a human explicitly "signing off" on it.

It turns the @ai-gen tag into a mandatory review checkpoint.

Features

• Real-time Monitoring: Instantly detects @ai-gen docblocks in your code.
• Visual Warning: Highlights unverified AI code with a Warning squiggly line.
• The "Ack" Workflow: The warning persists until you append ok (or reviewed, checked) to the tag (you can set your own).
• Context Aware: Highlights not just the comment, but the code block immediately following it, ensuring you see exactly what needs review.

How it Works

1. The Warning State ⚠️

When you paste or generate code with the tag @ai-gen, Ack-AI flags it immediately.

/**
 * @ai-gen
 * This function was written by AI and hasn't been read by a human yet.
 */
function riskyBusiness() {
    // ...
}

Result: The docblock and the function are highlighted yellow.

2. The Acknowledged State ✅

To clear the warning, you must review the code and explicitly "Ack" it by adding ok to the tag.

/**
 * @ai-gen ok
 * Reviewed by Dave on 2024-05-12. Logic verified.
 */
function riskyBusiness() {
    // ...
}

Result: The warning disappears. The code is now considered safe.

Supported Languages

Ack-AI currently provides diagnostics for:

• PHP (.php)
• JavaScript (.js, .jsx)
• TypeScript (.ts, .tsx)

Configuration

No configuration needed! Just install and start reviewing.

• Trigger: @ai-gen
• Safe Keywords: ok (Case insensitive)

Installation

1. Open VS Code.
2. Press F1, type ext install, and search for Ack-AI.
3. Click Install.

Always verify.