cli.directory

ruff

Agent-readyGit & GitHubProductivity

Linting, formatting, and python code quality from the terminal.

Linting, formatting, and python code quality from the terminal. Built by Astral.

Task fit

linting, formatting, and python code quality from the terminal.

Lane

Review PRs, triage issues, inspect workflows, and keep repo work agent-safe.

Operator brief

Use ruff for linting, formatting, and python code quality from the terminal.

Run `ruff check . && ruff format .` and see what comes back.

Repository family

Astral

First trust check

ruff responds locally and is ready for the first real command.

Safe first loop

Install, verify, then run one real command.

GitHub review loop

Install command

$ brew install ruff

Operator pack

Copy or export the working notes for this CLI before handing it to an agent.

Verify

$ ruff --version

ruff responds locally and is ready for the first real command.

First real command

$ ruff check . && ruff format .

First steps

  1. 01Install ruff.
  2. 02Run `ruff --version` first.
  3. 03Start with `ruff check . && ruff format .`.
  4. 04Install the CLI and make sure it is on your PATH.

When to use / hold off when

Best for

linting, formatting, and python code quality from the terminal.

Use this when

You need productivity workflows in both local dev and CI.

Hold off when

You don't work with productivity workflows.

Trust and constraints

trusted100/100
Install readyTrusted
JSON outputNo
Non-interactiveYes
CI-friendlyYes

Why operators pick it

  • ruff fits git & github well, especially for linting, formatting, and python code quality from the terminal.
  • 11,831 homebrew installs (30d).
  • Easy to automate.

Constraints

  • Output is mostly plain text.

Facts and links

Install withbrew
Homebrew installs (30d)11.8K
GitHub stars46.7K
LicenseMIT
UpdatedMar 25, 2026
DocumentationOpenGitHubOpenWebsiteOpen