Documentation

Agent handoff.

aislop fix resolves the safe stuff. For the rest — as any casts, oversized functions, complex refactors — it hands off to your coding agent with a prompt containing every remaining diagnostic and where to find it.

How it works

Run aislop fix first — it'll auto-resolve everything that's mechanically safe. Whatever's left is where judgment starts.

Then run aislop fix --<agent>. aislop builds a prompt listing every remaining diagnostic with file paths, line numbers, rule IDs, and severity — then launches your agent's CLI with that prompt pre-filled.

# safe fixes first

$ npx aislop fix

# hand off to Claude Code

$ npx aislop fix --claude

Supported agents

Fourteen agents supported. The flag invokes the agent's local CLI — you need that agent installed.

--claude

Claude Code

--codex

OpenAI Codex CLI

--cursor

Cursor agent

--gemini

Gemini CLI

--windsurf

Windsurf

--aider

Aider

--goose

Block Goose

--amp

Sourcegraph Amp

--antigravity

Antigravity

--deep-agents

Deep Agents

--kimi

Kimi CLI

--opencode

OpenCode

--warp

Warp AI

--vscode

VS Code Copilot

Agent-agnostic: --prompt

If your agent isn't listed, or you want to paste the prompt into a web UI, use --prompt. aislop prints the full handoff prompt to stdout; pipe it wherever:

# copy on macOS

$ npx aislop fix --prompt | pbcopy

$ npx aislop fix --prompt > prompt.txt

What's in the prompt

The current score and label (Healthy / Needs Work / Critical)
Every remaining diagnostic, grouped by file, with line numbers and rule IDs
Short description of what each rule catches, so the agent knows why the issue matters
Priority hint — errors first, then high-severity warnings, then the rest
Instruction to leave auto-fixable items alone (aislop fix handles those)