1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
# Hexai sectioned config example
[general]
max_tokens = 4000
max_context_tokens = 4000
context_mode = "always-full" # minimal | window | file-on-new-func | always-full
context_window_lines = 120
coding_temperature = 0.2 # single knob for LSP calls (optional)
[logging]
# Flatten to: log_preview_limit
log_preview_limit = 100 # chars shown in log previews
[completion]
completion_debounce_ms = 800 # idle ms before sending a request
completion_throttle_ms = 0 # min ms between requests (0 disables)
manual_invoke_min_prefix = 0 # required identifier chars for manual invoke
[triggers]
trigger_characters = [".", ":", "/", "_", " "]
[inline]
inline_open = ">" # single-character
inline_close = ">" # single-character
[chat]
chat_suffix = ">" # single-character
chat_prefixes = ["?", "!", ":", ";"] # single-character items
[models]
# Shorthand string form per surface (single entry)
# completion = "gpt-4o-mini"
# chat = "gpt-4.1"
# Full array form for multiple entries
# [[models.completion]]
# provider = "openai"
# model = "gpt-4o-mini"
# temperature = 0.2
#
# [[models.completion]]
# provider = "ollama"
# model = "mistral"
# temperature = 0.2
# [[models.code_action]]
# # Only the first entry is used; extras are ignored with a warning.
# provider = "copilot"
# model = "gpt-4o"
# temperature = 0.4
# [[models.cli]]
# provider = "openai"
# model = "gpt-4.1"
# temperature = 0.6
[provider]
name = "openai" # openai | copilot | ollama
[openai]
model = "gpt-4.1"
base_url = "https://api.openai.com/v1"
temperature = 0.2
[copilot]
model = "gpt-4o-mini"
base_url = "https://api.githubcopilot.com"
temperature = 0.2
[ollama]
model = "qwen3-coder:30b-a3b-q4_K_M"
base_url = "http://localhost:11434"
temperature = 0.2
# Prompt templates (optional). Leave commented to use defaults.
[prompts]
[prompts.completion]
# Templates support {{file}}, {{function}}, {{above}}, {{current}}, {{below}}, {{char}}
# and for additional context: {{context}}
# system_general = "You are a terse code completion engine. Return only the code to insert, no surrounding prose or backticks. Only continue from the cursor; never repeat characters already present to the left of the cursor on the current line (e.g., if 'name :=' is already typed, only return the right-hand side expression)."
# system_params = "You are a code completion engine for function signatures. Return only the parameter list contents (without parentheses), no braces, no prose. Prefer idiomatic names and types."
# system_inline = "You are a precise code completion/refactoring engine. Output only the code to insert with no prose, no comments, and no backticks. Return raw code only."
# user_general = "Provide the next likely code to insert at the cursor.\nFile: {{file}}\nFunction/context: {{function}}\nAbove line: {{above}}\nCurrent line (cursor at character {{char}}): {{current}}\nBelow line: {{below}}\nOnly return the completion snippet."
# user_params = "Cursor is inside the function parameter list. Suggest only the parameter list (no parentheses).\nFunction line: {{function}}\nCurrent line (cursor at {{char}}): {{current}}"
# additional_context = "Additional context:\n{{context}}"
[prompts.provider_native]
# completion = "// Path: {{path}}\n{{before}}"
[prompts.chat]
# system = "You are a helpful coding assistant. Answer concisely and clearly."
[prompts.code_action]
# rewrite_system = "You are a precise code refactoring engine. Rewrite the given code strictly according to the instruction. Return only the updated code with no prose or backticks. Preserve formatting where reasonable."
# diagnostics_system = "You are a precise code fixer. Resolve the given diagnostics by editing only the selected code. Return only the corrected code with no prose or backticks. Keep behavior and style, and avoid unrelated changes."
# document_system = "You are a precise code documentation engine. Add idiomatic documentation comments to the given code. Preserve exact behavior and formatting as much as possible. Return only the updated code with comments, no prose or backticks."
# rewrite_user = "Instruction: {{instruction}}\n\nSelected code to transform:\n{{selection}}"
# diagnostics_user = "Diagnostics to resolve (selection only):\n{{diagnostics}}\n\nSelected code:\n{{selection}}"
# document_user = "Add documentation comments to this code:\n{{selection}}"
# go_test_system = "You are a precise Go unit test generator. Given a Go function, write one or more Test* functions using the testing package. Do NOT include package or imports, only the test function(s). Prefer table-driven tests. Keep it minimal and idiomatic."
# go_test_user = "Function under test:\n{{function}}"
# simplify_system = "You are a precise code improvement engine. Simplify and improve the given code while preserving behavior. Return only the improved code with no prose or backticks."
# simplify_user = "Improve this code:\n{{selection}}"
# Define additional custom code actions (optional)
# [[prompts.code_action.custom]]
# id = "extract-function" # required, unique slug (case-insensitive)
# title = "Extract function" # required, appears in LSP and tmux
# kind = "refactor.extract" # optional (default: "refactor")
# scope = "selection" # optional: selection | diagnostics (default: selection)
# hotkey = "e" # optional, single character for tmux submenu
# instruction = "Extract selected code into a new function named 'extracted' and replace with a call. Return only code, no backticks."
# [[prompts.code_action.custom]]
# id = "fix-lints"
# title = "Fix linters"
# kind = "quickfix"
# scope = "diagnostics"
# hotkey = "l"
# system = "You are a precise code fixer. Only change selected code."
# user = "Diagnostics to resolve (selection only):\n{{diagnostics}}\n\nSelected code:\n{{selection}}"
[prompts.cli]
# default_system = "You are Hexai CLI. Default to very short, concise answers. If the user asks for commands, output only the commands (one per line) with no commentary or explanation. Only when the word 'explain' appears in the prompt, produce a verbose explanation."
# explain_system = "You are Hexai CLI. The user requested an explanation. Provide a clear, verbose explanation with reasoning and details. If commands are needed, include them with brief context."
[tmux]
# custom_menu_hotkey = "a" # hotkey to open the custom actions submenu in hexai-tmux-action
[stats]
# window_minutes = 60 # sliding window for global stats (Σ@window); min 1, max 1440
|
