Configuration

config.toml reference covering clipboard, autocomplete, and AI.

Location

Path: ~/.config/jiq/config.toml (all platforms). Optional — defaults are reasonable; only AI requires config.

Clipboard

[clipboard]
backend = "auto"

Value	Use when
auto (default)	OS clipboard first, OSC 52 fallback.
system	Local desktop only.
osc52	SSH / tmux / mosh on a terminal that forwards OSC 52 (Ghostty, kitty, WezTerm, foot).

Theme

[theme]
mode = "auto"

Value	Effect
auto (default)	Detect the terminal background at startup and pick the light or dark palette. Falls back to dark if detection is unavailable (e.g. inside tmux/screen without passthrough, or a non-responding terminal).
light	Force the light palette.
dark	Force the dark palette (the classic Galaxy theme).

Autocomplete

[autocomplete]
array_sample_size = 10

For heterogeneous arrays, increase to union more keys (range: 1–1000).

Tooltip

[tooltip]
auto_show = true

When true (default), the function tooltip appears automatically as the cursor lands on a known jq function. Set to false to require Ctrl+T to open it.

AI

[ai]
enabled            = true
provider           = "anthropic"   # "openai" | "gemini" | "bedrock"
max_context_length = 100000        # characters of schema/sample context

Provider	Recommended model
Anthropic	claude-haiku-4-5-20251001
OpenAI	gpt-4o-mini
Gemini	gemini-3-flash
Bedrock	global.anthropic.claude-haiku-4-5-20251001-v1:0

See AI assistant for per-provider config.

Full example

[clipboard]
backend = "auto"

[theme]
mode = "auto"

[autocomplete]
array_sample_size = 25

[ai]
enabled            = true
provider           = "anthropic"
max_context_length = 80000

[ai.anthropic]
api_key = "sk-ant-..."
model   = "claude-haiku-4-5-20251001"

Environment overrides

Variable	Effect
JIQ_DEBUG=1	Same as --debug: write debug logs to /tmp/jiq-debug.log.

See Troubleshooting.