federiq [--config PATH] [-v] <subcommand>
Every subcommand accepts --help for detail. A condensed reference:
| Subcommand | Purpose |
|---|
init | Scaffold a new federiq.yaml |
sources list | List declared sources |
sources add | Add a source |
sources remove | Remove a source |
sources test | Verify one or all sources are reachable |
sources describe | Show source detail and generated ATTACH SQL |
schema list | List tables in a source |
schema describe | Show column types for a table |
query | Execute SQL (see flags below) |
shell | Interactive REPL |
serve | HTTP server with auth + TLS + metrics |
config show | Print resolved catalog YAML |
config validate | Lint catalog sources |
policy list | List policies |
policy show | Show one policy |
policy validate | Cross-check policies against sources |
policy check | Static violation scan for a SQL query |
cache status | Cache statistics |
cache clear | Empty the cache |
doctor | Environment diagnostics |
completions <shell> | Emit shell completion scripts |
| Flag | Meaning |
|---|
-f, --file PATH | Read SQL from a file |
-o, --output PATH | Write results to a file |
--format FMT | table (default), csv, json, ndjson, parquet |
--explain | Print DuckDB plan |
--explain-analyze | Plan plus per-operator timing |
--timing | Print total and per-source timing |
--cache MODE | off / memory / disk |
--cache-dir PATH | Disk cache location |
--enforce-policy BOOL | Default true when catalog has policies |