New Features

• add support for OSC52 clipboard codes (#1280)
• abandon support for lingyiwanwu client (#1327)
• support autodetecting dark/light theme (#1335)
• enhence .regenerate (#1340)
• ctrl+j for newline (#1342)

Bug Fixes

• use_tools in agent mode (#1252)
• visual indication of Vi insert/normal model (#1279)
• better error handling for aichat -e on MacOS (#1311)
• openai api omits content field from tool_calls message (#1326)
• change temperature/top_p reading rules (#1333)
• .file external commands capture stdout/stderr (#1343)

New Contributors

• @laktak made their first contribution in #1279
• @gcv made their first contribution in #1280

Full Changelog: v0.29.0...v0.30.0

New Features

• add cmd_prelude and remove prelude (#1197)
• support claude-3-7-sonnet (#1201)
• bumping Azure OpenAI API Version to 2024-12-01-preview (#1205)
• --code (tty) strips <think> tag (#1227)
• enhence glob for --file and rag docs (#1230)
• support HISTFILE to specify the bash/zsh history file (#1236)

Bug Fixes

• incorrect model when switching role in session context (#1192)
• bedrock handles empty tool call arguments (#1213)
• openai-compatible handles empty tool call arguments (#1217)
• miss </think> tag while tool calling (#1226)

New Contributors

• @dbroeglin made their first contribution in #1205
• @blankjul made their first contribution in #1213
• @cramosc made their first contribution in #1236

Full Changelog: v0.28.0...v0.29.0

New Features

• display reasoning tokens (#1139)
• webui support think tag (#1140)
• strip reasoning contents (#1141)
• support model alias (#1150)
• enhance .file for loading resources from diverse sources (#1155)
• supports selecting LLM during configuration initialization (#1158)
• supports fetching models during configuration initialization (#1161)
• new model field system_prompt_prefix (#1163)
• remove predefined models for ollama (#1165)
• add model field patch (#1169)
• add patch max_tokens: null to openai/github o* serial models (#1174)
• remove supports for hyperbolic and novita (#1176)
• remove supports for fireworks/siliconflow/together (#1181)
• openai/github providers add o3-mini-high model (#1182)

Bug Fixes

• messages with tool_calls have not been saved to messages.md (#1156)
• webui sessions do not persist system prompt (#1162)
• webui settings do not work (#1175)
• better handle OpenAI-Compatible streaming responses (#1184)

New Contributors

• @mtul0729 made their first contribution in #1138
• @wwsheng009 made their first contribution in #1184

Full Changelog: v0.27.0...v0.28.0

REPL Changes

.file %%                                  # Include last reply with `%%`
.file `git diff`                          # Include command execution with `<cmd>`
.macro <macro> [arg]...                   # Execute macro
.edit config                              # Modify configuration file
.edit agent-config                        # Modify agent configuration file
.agent <agent> <variable:key=value>...    # Accept agent variables

New CLI Options

  --rebuild-rag                    Rebuild the RAG to sync document changes
  --macro <MACRO>                  Execute a macro
  --list-macros                    List all macros
  --sync-models                    Sync models updates

New Providers

• minimax
• hyperbolic
• novita

New Features

• add cli option --rebuild-rag (#1074)
• .file supports external command execution (#1075)
• .file supports including last reply with %% (#1079)
• discontinue rag_min_score_* config items (#1081)
• support default terminal editor (#1082)
• no longer support .set agent_prelude <value> (#1086)
• support macro (#1087)
• .agent accept variable key-value pairs (#1090)
• support minimax client (#1091)
• no longer support .variable repl command (#1092)
• .starter accepts index other than text (#1093)
• add a default base_url to ollama (#1102)
• support .edit config and .edit agent-config repl commands (#1103)
• add --sync-models cli option (#1114)
• support hyperbolic client (#1115)
• ernie migrates to v2 api (#1130)
• add novita client (#1132)

Full Changelog: v0.26.0...v0.27.0

New Features

• supports override agent instructions via agent config (#1057)
• support gemini-2.0-flash-thinking-exp (#1067)

Bug Fixes

• invalid schema that array schema missing items (#1049)
• .file path args do not need double backslash on Windows (#1053)
• agent variables don't initialized if start session with last message (#1054)
• don't trim the input text (#1056)

Full Changelog: v0.25.0...v0.26.0

New Features

• handle Ctrl+C during every spinner in REPL (#1014)
• support all proxy env vars including NO_PROXY (#1015)
• agent supports dynamic instructions (#1023)
• append shell execute command to history file (#1026)
• add cli option --agent-variable <name> <value> (#1027)
• --file/.file accept file formats in document_loaders (#1033)
• webui playground support multiple sessions in memory (#1035)
• webui supports math in markdown (#1039)
• update cohere api to v2 (#1041)

Bug Fixes

• stream function calling for some openai-compatible clients (#1017)

Full Changelog: v0.24.0...v0.25.0

REPL Changing

- .save agent-config       Save the current agent config to file
+ .edit rag-docs           Edit the RAG documents

New Features

• .info role/.exit role works for session role (#958)
• support .edit rag-docs (#964)
• change agent config/variables (#967)
• support session-scoped agent variables (#969)
• .agent accepts session name (#970)
• add config user_agent (#971)
• support overriding agent config with env vars (#974)
• add hunyuan client (#980)
• remove supports for huggingface (#988)
• support env <AGENT_NAME>_CONFIG_FILE (#990)
• save function calls in the session (#994)
• support autonaming session (#1001)

Bug Fixes

• unexpected Ctrl-C/Ctrl-D handling in non-stream REPL Chat (#957)
• WebUI unsupported value error when invoking o1-* models (#983)
• invalid request on qianwen multi tool-calls (#993)

Break Changing

Respect XDG_CONFIG_HOME for placing config dir

Drop replicate client and remove support for octoai

REPL Changing

- .clear messages          Erase messages in the current session
+ .empty session           Erase messages in the current session
+ .compress session        Compress messages in the current session

CLI Changing

+ --empty-session          Ensure the session is empty

New Features

• add batch_size to RAG yaml (#876)
• add retry logic to embedding/rerank api calls (#879)
• add AICHAT_EMBEDDINGS_RETRY_LIMIT (#882)
• respect XDG_CONFIG_HOME for placing config dir (#889)
• change prompt for choosing shell command actions (#898)
• abandon replicate client (#900)
• remove support for octoai (#901)
• when saving input to message.md, use file paths instead of file contents (#905)
• add .compress session REPL command (#907)
• prelude supports : (#913)
• session persists role name (#914)
• webui supports pasting images (#921)
• add CLI option --empty-session (#922)
• rename .clear messages to .empty session (#923)
• add shell action copy (#926)
• support openai o1 models (#935)
• support xai (grok) client (#945)

Bug Fixes

• allow reading from special files (device, fifo, etc) (#886)
• unexpected REPL without tty (#911)
• prelude works only if the state is empty (#920)
• unexpected error while piping to shell execution on macOS (#930)

RAG Changes

Store RAG in YAML format instead of bin format

We used to store RAG in bin format at <aichat-config-dir>/rags/<name>.bin. However, the bin format has various drawbacks, so we are now using the yaml format to store RAG.

All RAGs in bin format will be ignored. Please recreate them in YAML format.

Support for RAG-scoped top_k and reranker_model options

Now, users can set the top_k and reranker_model parameters individually for each RAG.

.set rag_top_k 5
.set rag_reranker_model cohere:rerank-english-v3.0

New REPL Commands

.delete                  Delete roles/sessions/RAGs/agents
.save agent-config       Save the current agent config to file
.sources rag             View the RAG sources in the last query

New Features

• add config serve_addr & env $SERVE_ADDR for specifying serve addr (#839)
• better html to markdown converter (#840)
• add role %create-prompt% (#843)
• tolerate failure to load some rag files (#846)
• support RAG-scoped rag_top_k and rag_reranker_model (#847)
• save rag in YAML instead of bin (#848)
• chat-completions api supports tools (#850)
• support rerank api (#851)
• abandon config rag_min_score_rerank (#852)
• add .delete repl command (#862)
• no delete the existing role/session when saving with a new name (#863)
• specify shell via $AICHAT_SHELL (#866)
• role/session/agent should not inherit the global use_tools (#868)
• add .save agent-config repl command (#870)
• add .sources rag repl command (#871)

Bug Fixes

• render stream failed due to read cursor position timeout (#835)

What's Changed

• fix: : cannot be used as seperator for role arguments #830
• feat: add siliconflow client #831

Break Changing in v0.21.0

Replace roles.yaml with roles/<name>.md (see #804)

Migrate ollama/qianwen/cloudflare clients to openai-compatible

clients:

-  - type: ollama
-    api_base: http://localhost:11434
+  - type: openai-compatible
+    name: ollama
+    api_base: http://localhost:11434/v1

-  - type: qianwen
+  - type: openai-compatible
+    name: qianwen

-  - type: cloudflare
-    account_id: xxx
-    api_base: https://api.cloudflare.com/client/v4
+  - type: openai-compatible
+    name: cloudflare
+    api_base: https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/v1