loq 0.1.0a3

Enforce file size constraints

loq

An electric fence for LLMs (and humans too).

Why file size matters

Big files mean more tokens. More tokens mean:

• Slower responses - LLMs take longer to process what they don't need
• Higher costs - you pay per token
• Context rot - large files become dumping grounds that overwhelm both LLMs and humans

loq stops the sprawl before it starts.

Why loq?

LLMs are great at generating code, but sometimes they go off the rails. You can tell an LLM what to do, but the only way to guarantee it listens is with feedback loops and hard constraints. loq provides that constraint: a fast, dead-simple way to enforce file size limits.

Linters like Ruff and ESLint check correctness. loq checks size. It does one thing: enforce line counts (wc -l style). No parsers, no plugins, language agnostic. One tool for your entire polyglot monorepo.

Getting started

Installation

# With uv (recommended)
uv tool install loq

# With pip
pip install loq

# With cargo
cargo install loq

Usage

loq                                        # Check current directory (zero-config, 500 line default)
loq check src/ lib/                        # Check specific paths
git diff --name-only | loq check -         # Check files from stdin

Pre-commit

# .pre-commit-config.yaml
repos:
  - repo: local
    hooks:
      - id: loq
        name: loq
        entry: loq
        language: system
        pass_filenames: false

LLM-friendly output

Output is designed to be token-efficient:

✖  1_427 > 500   src/components/Dashboard.tsx
✖    892 > 500   src/utils/helpers.py
2 violations (14ms)

Use loq -v for additional context:

✖  1_427 > 500   src/components/Dashboard.tsx
                  └─ rule: max-lines=500 (match: **/*.tsx)

Configuration

loq works zero-config. Run loq init to customize:

default_max_lines = 500       # files not matching any rule
respect_gitignore = true      # skip .gitignore'd files
exclude = ["**/generated/**"] # additional patterns to skip

[[rules]]                     # last match wins
path = "**/*.tsx"
max_lines = 300

[[rules]]
path = "tests/**/*"
max_lines = 600

Baseline

Have a codebase with existing large files? Baseline them:

loq init       # Create loq.toml first
loq baseline   # Add rules for files over the limit

Run loq baseline periodically to ratchet down. It automatically:

• Adds rules for new violations
• Updates rules when files shrink (tightens the limit)
• Removes rules when files drop below the threshold

Use --threshold to override the default limit:

loq baseline --threshold 300

Contributing

Contributions are welcome! See CONTRIBUTING.md for development setup and guidelines.

License

This project is licensed under the MIT License.