Browse the CQLi reference manual by chapter for easy navigation, or the all-in-one version for full-page browsing and in-page search.
Manual Chapters
Introduction
Overview, scope, and key context.
CQL Fundamentals
Core syntax, types, and query basics.
Comments
Comment behavior, ordering, and smart comments.
Board State Filters
Board state, legality, and position filters.
Board Geometry Filters
Squares, directions, files, ranks, and geometry.
Ray Filters
Rays, xrays, pins, and directional patterns.
Metadata Filters
PGN tags, results, ratings, and metadata.
The Gametree Filters
Game tree structure, positions, and ancestry.
Position Relationship Filters
Find, echo, and positional relationship searches.
The sort Filter
Sorting matching games by computed values.
The move Filter
Played and hypothetical move evaluation.
The line Filter
Sequence matching across positions and moves.
Selection and Iteration Filters
Control flow, loops, and iteration filters.
Functions
Define reusable query functions.
Transform Filters
Rotations, reflections, shifts, and transforms.
Imaginary Position Exploration
Imagined positions, mutations, and reachability.
Chess Variants
Variant support and variant-specific semantics.
Other Features
Piece tracking, extensibility, hhdb interface, debugging, and more.
Synoptic Examples
Practical short examples and query recipes.
Expository Examples
Long-form worked examples and pattern studies.
Filter Conspectus
Reference tables for filters and keywords.
Commandline Options
CLI options, flags, and injected filters.
Diagnostics
Errors, warnings, and diagnostic behavior.
Revision History
Release notes and historical changes.
Appendix A: Differences Between CQL 6.1
CQLi differences from CQL 6.1.
Appendix B: Open Source Declarations
Third-party software notices.
Appendix C: Other Resources
Further reading, databases, and references.
Appendix D: License
License terms.