Repository navigation
Releases
Habibi v0.6.1
Habibi v0.6.1
Fix the RAM status indicator on macOS.
- Read current-process resident memory using macOS
proc_pidinfoinstead of always displayingRAM n/a. - Match Linux RSS semantics: current memory, not peak usage, with child processes excluded. No subprocesses or elevated permissions are needed.
- Preserve
n/aas a safe fallback if the OS query fails. - Add a runtime RSS regression test for Linux and both macOS CI architectures.
Existing configuration and session journals remain compatible. macOS binaries remain unsigned and not notarized.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi after upgrading. Enable the RAM indicator in /settings if it is hidden.
Habibi v0.6.0
Native image reading for vision-capable models.
- Image attachments:
readdetects PNG, JPEG, GIF, and WebP by signature and sends native image content through Codex, Claude, and Ollama adapters, rather than base64 text. - Model capabilities: Ollama checks reported vision support before sending images. Hosted providers validate the selected model; a vision-capable model is required.
- Code mode and resume: approved child image reads are automatically forwarded to the model, and attachments persist in session journals. Code-mode attachments have an 8 MiB combined base64 limit.
- Useful binary-file errors: PDFs and other non-text files receive extraction guidance instead of opaque UTF-8 errors. Automatic PDF extraction is not included.
- Preserved safeguards: file approvals, workspace confinement, regular-file checks, and the 2 MiB file limit remain in place. Image context accounting uses a 16 KiB text-equivalent estimate per image.
Existing journals remain readable. Journals containing images include the image data and should be treated as sensitive. Library users constructing ToolOutput or Message::ToolResult must supply the new images field. Live provider vision testing is not included in automated validation. macOS binaries remain unsigned and not notarized.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi after upgrading and select a vision-capable model to read images.
Habibi v0.5.0
A more terminal-like prompt editor and a folder-scoped session browser.
- Session picker:
/resumeopens a searchable, newest-first list for the current folder, with original first-user/latest-message previews. Arrow keys or wheel select, Enter resumes, Esc closes. Narrow terminals stack the panes. Browsing is read-only; locked/invalid sessions leave the current session intact. Saved model and permissions are restored, and local control clients must rediscover the new socket. Preview/file-count limits are documented in the README. - Safer Ctrl-C: clears a nonempty draft first, without quitting or interrupting the agent. With an empty prompt it cancels an active run or quits when idle. Esc still interrupts immediately.
- Editable prompt history: Up/Down or Ctrl-P/N browses up to 100 submitted prompts, including queued messages and commands. Down past the newest restores the unfinished draft and cursor. Available user messages seed history on resume. Autocomplete retains Up/Down priority while open; Ctrl-N retains approval-denial priority.
- Terminal editing: Ctrl-A/E or Home/End for line boundaries; Ctrl-B/F for characters; Alt-B/F or Ctrl/Alt-arrow keys for words; Ctrl-W and Alt-D for word deletion; Ctrl-K for deleting to line end; Ctrl-D/H for delete/backspace. Ctrl-U still clears the whole draft. Unicode character boundaries are preserved.
- Select and copy: mouse scrolling remains enabled, with no
/mousecommand. Use your terminal's selection override (commonly Shift-drag), then its copy shortcut. Ctrl-C is not copy. Selection remains terminal-owned, not a whole-session export.
Existing configuration and session journals remain compatible. No new global history file is written. Terminal modifier support varies. macOS binaries remain unsigned and not notarized.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi after upgrading.
Habibi v0.4.1
MCP OAuth from the terminal UI and CLI.
What's new
- Authenticate from
/mcp: select a saved HTTP server and press a. Browser authorization runs without blocking the terminal; the dialog shows a fallback link and accepts a privately pasted full callback URL. Esc or Ctrl-C cancels. Press l to remove local credentials. The server list shows saved OAuth versus explicit bearer authentication. - CLI authentication:
habibi mcp login|status|logout SERVER, with login options--client-id, repeatable--scope, and--callback-portfor pre-registered public clients. - Automatic refresh: Streamable HTTP connections use endpoint-bound saved OAuth when no bearer environment variable is configured. Expired tokens refresh through the MCP SDK, with cross-process locking and atomic private credential storage.
- Protocol protections: discovery, S256 PKCE, callback state/origin/duplicate-parameter checks, issuer binding on every credential read, and bounded callback input. Provider response bodies are not exposed through OAuth/transport error messages.
- Library opt-in:
mcp_oauth::{Store, Login, LoginOptions}andmcp::connect_with_oauth_store; existing callers ofmcp::connectkeep their previous behavior.
Compatibility and limits
Existing server configuration and journals remain compatible. Explicit bearer-env configuration takes precedence. OAuth requires published metadata with an issuer and a public client (dynamic registration or a supplied client ID); confidential clients and legacy HTTP+SSE are not supported. Login never starts automatically from a model/tool request. Credentials live in private files, not an encrypted keychain. Logout deletes local credentials, not provider grants, and cannot recall in-flight requests. macOS binaries remain unsigned and not notarized.
Validation
Hermetic tests exercise discovery, dynamic/public registration, PKCE token exchange, loopback callbacks, automatic refresh during MCP initialization, issuer changes, endpoint isolation, logout, cancellation/denial, file permissions, lock contention, and hidden UI input. Full workspace tests, Clippy, Rust 1.89 compatibility, installer checks, and terminal smoke tests run before release. Live third-party OAuth accounts have not been tested.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi, open /mcp, select a saved HTTP server with no bearer environment field, and press a.
Habibi v0.4.0
Local agent control, headless workflows, MCP, and embedded code mode.
What's new
- Control any running instance: the TUI,
-p, and--rpceach expose a private Unix socket. Send JSON Lines requests for status, prompts, steering, follow-ups, approvals, stop, and shutdown without taking over the terminal. Startup output shows the path; discovery metadata identifies the process and session. Client disconnects leave work running. - Headless and stdio RPC:
habibi -p "…"streams text and exits;habibi --rpcserves a persistent event/request protocol. Explicit--yolois required for headless auto-approval regardless of saved TUI preferences. Stdio RPC supports individual tool approvals. - MCP integration and editor: connect trusted stdio and Streamable HTTP servers from user configuration.
/mcpoffers forms for server arguments, environment references, URLs, enable/disable, and removal, with atomic saves and external-change detection. Connections start on the first prompt; repository MCP configuration is never loaded. - Embedded code mode: QuickJS scripts compose registered tools with bounded parallelism, output, execution time, and memory. Child calls retain individual Ask/YOLO approvals and audit records. No external JavaScript runtime is required.
- Extensible library tools: register custom tools with validated input schemas and connect MCP servers through
libhabibi. - Transient provider retries: Codex, Claude, and Ollama retry connection failures, timeouts, and selected transient HTTP errors up to five times with cancellable backoff. Partial streams are not retried; tool calls are not replayed.
- Command and skill completion: a five-row list above the prompt includes discovered
/skill:nameentries. Up/Down selects, Tab completes, and partial matches can be accepted with Enter. Loading skill bodies remains approval-gated. - Documentation and GitHub Pages: updated getting-started guidance, release information, and the local RPC protocol reference.
Compatibility and safety
Existing journals remain readable. Journals containing new code-mode child-call audit records require v0.4.0 or later; older binaries cannot read those records. MCP/code-mode preferences persist in sessions and user defaults; both features are enabled by default. MCP programs run only when explicitly configured, but starting configured programs does not require a tool approval.
Socket directories are created with mode 0700 and sockets with mode 0600. Other processes running as your user can control the agent, including approving tools. Socket transport is request/reply only, not an event stream. Plain -p remains one-shot and denies tools unless --yolo is explicit. Normal exit removes discovery files; forced termination may leave stale entries.
Tool approval is not sandboxing: shell commands and MCP programs retain your account's filesystem/network access. Code-mode limits do not restrict the capabilities of approved tools. Cancellation cannot undo completed local or remote side effects. Saved TUI YOLO defaults apply to future new TUI sessions in every directory.
Subscription adapters remain experimental and ar...
Habibi v0.6.0
Habibi v0.6.0
Native image reading for vision-capable models.
- Image attachments:
readdetects PNG, JPEG, GIF, and WebP by signature and sends native image content through Codex, Claude, and Ollama adapters, rather than base64 text. - Model capabilities: Ollama checks reported vision support before sending images. Hosted providers validate the selected model; a vision-capable model is required.
- Code mode and resume: approved child image reads are automatically forwarded to the model, and attachments persist in session journals. Code-mode attachments have an 8 MiB combined base64 limit.
- Useful binary-file errors: PDFs and other non-text files receive extraction guidance instead of opaque UTF-8 errors. Automatic PDF extraction is not included.
- Preserved safeguards: file approvals, workspace confinement, regular-file checks, and the 2 MiB file limit remain in place. Image context accounting uses a 16 KiB text-equivalent estimate per image.
Existing journals remain readable. Journals containing images include the image data and should be treated as sensitive. Library users constructing ToolOutput or Message::ToolResult must supply the new images field. Live provider vision testing is not included in automated validation. macOS binaries remain unsigned and not notarized.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi after upgrading and select a vision-capable model to read images.
Habibi v0.5.0
A more terminal-like prompt editor and a folder-scoped session browser.
- Session picker:
/resumeopens a searchable, newest-first list for the current folder, with original first-user/latest-message previews. Arrow keys or wheel select, Enter resumes, Esc closes. Narrow terminals stack the panes. Browsing is read-only; locked/invalid sessions leave the current session intact. Saved model and permissions are restored, and local control clients must rediscover the new socket. Preview/file-count limits are documented in the README. - Safer Ctrl-C: clears a nonempty draft first, without quitting or interrupting the agent. With an empty prompt it cancels an active run or quits when idle. Esc still interrupts immediately.
- Editable prompt history: Up/Down or Ctrl-P/N browses up to 100 submitted prompts, including queued messages and commands. Down past the newest restores the unfinished draft and cursor. Available user messages seed history on resume. Autocomplete retains Up/Down priority while open; Ctrl-N retains approval-denial priority.
- Terminal editing: Ctrl-A/E or Home/End for line boundaries; Ctrl-B/F for characters; Alt-B/F or Ctrl/Alt-arrow keys for words; Ctrl-W and Alt-D for word deletion; Ctrl-K for deleting to line end; Ctrl-D/H for delete/backspace. Ctrl-U still clears the whole draft. Unicode character boundaries are preserved.
- Select and copy: mouse scrolling remains enabled, with no
/mousecommand. Use your terminal's selection override (commonly Shift-drag), then its copy shortcut. Ctrl-C is not copy. Selection remains terminal-owned, not a whole-session export.
Existing configuration and session journals remain compatible. No new global history file is written. Terminal modifier support varies. macOS binaries remain unsigned and not notarized.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi after upgrading.
Habibi v0.4.1
MCP OAuth from the terminal UI and CLI.
What's new
- Authenticate from
/mcp: select a saved HTTP server and press a. Browser authorization runs without blocking the terminal; the dialog shows a fallback link and accepts a privately pasted full callback URL. Esc or Ctrl-C cancels. Press l to remove local credentials. The server list shows saved OAuth versus explicit bearer authentication. - CLI authentication:
habibi mcp login|status|logout SERVER, with login options--client-id, repeatable--scope, and--callback-portfor pre-registered public clients. - Automatic refresh: Streamable HTTP connections use endpoint-bound saved OAuth when no bearer environment variable is configured. Expired tokens refresh through the MCP SDK, with cross-process locking and atomic private credential storage.
- Protocol protections: discovery, S256 PKCE, callback state/origin/duplicate-parameter checks, issuer binding on every credential read, and bounded callback input. Provider response bodies are not exposed through OAuth/transport error messages.
- Library opt-in:
mcp_oauth::{Store, Login, LoginOptions}andmcp::connect_with_oauth_store; existing callers ofmcp::connectkeep their previous behavior.
Compatibility and limits
Existing server configuration and journals remain compatible. Explicit bearer-env configuration takes precedence. OAuth requires published metadata with an issuer and a public client (dynamic registration or a supplied client ID); confidential clients and legacy HTTP+SSE are not supported. Login never starts automatically from a model/tool request. Credentials live in private files, not an encrypted keychain. Logout deletes local credentials, not provider grants, and cannot recall in-flight requests. macOS binaries remain unsigned and not notarized.
Validation
Hermetic tests exercise discovery, dynamic/public registration, PKCE token exchange, loopback callbacks, automatic refresh during MCP initialization, issuer changes, endpoint isolation, logout, cancellation/denial, file permissions, lock contention, and hidden UI input. Full workspace tests, Clippy, Rust 1.89 compatibility, installer checks, and terminal smoke tests run before release. Live third-party OAuth accounts have not been tested.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi, open /mcp, select a saved HTTP server with no bearer environment field, and press a.
Habibi v0.4.0
Local agent control, headless workflows, MCP, and embedded code mode.
What's new
- Control any running instance: the TUI,
-p, and--rpceach expose a private Unix socket. Send JSON Lines requests for status, prompts, steering, follow-ups, approvals, stop, and shutdown without taking over the terminal. Startup output shows the path; discovery metadata identifies the process and session. Client disconnects leave work running. - Headless and stdio RPC:
habibi -p "…"streams text and exits;habibi --rpcserves a persistent event/request protocol. Explicit--yolois required for headless auto-approval regardless of saved TUI preferences. Stdio RPC supports individual tool approvals. - MCP integration and editor: connect trusted stdio and Streamable HTTP servers from user configuration.
/mcpoffers forms for server arguments, environment references, URLs, enable/disable, and removal, with atomic saves and external-change detection. Connections start on the first prompt; repository MCP configuration is never loaded. - Embedded code mode: QuickJS scripts compose registered tools with bounded parallelism, output, execution time, and memory. Child calls retain individual Ask/YOLO approvals and audit records. No external JavaScript runtime is required.
- Extensible library tools: register custom tools with validated input schemas and connect MCP servers through
libhabibi. - Transient provider retries: Codex, Claude, and Ollama retry connection failures, timeouts, and selected transient HTTP errors up to five times with cancellable backoff. Partial streams are not retried; tool calls are not replayed.
- Command and skill completion: a five-row list above the prompt includes discovered
/skill:nameentries. Up/Down selects, Tab completes, and partial matches can be accepted with Enter. Loading skill bodies remains approval-gated. - Documentation and GitHub Pages: updated getting-started guidance, release information, and the local RPC protocol reference.
Compatibility and safety
Existing journals remain readable. Journals containing new code-mode child-call audit records require v0.4.0 or later; older binaries cannot read those records. MCP/code-mode preferences persist in sessions and user defaults; both features are enabled by default. MCP programs run only when explicitly configured, but starting configured programs does not require a tool approval.
Socket directories are created with mode 0700 and sockets with mode 0600. Other processes running as your user can control the agent, including approving tools. Socket transport is request/reply only, not an event stream. Plain -p remains one-shot and denies tools unless --yolo is explicit. Normal exit removes discovery files; forced termination may leave stale entries.
Tool approval is not sandboxing: shell commands and MCP programs retain your account's filesystem/network access. Code-mode limits do not restrict the capabilities of approved tools. Cancellation cannot undo completed local or remote side effects. Saved TUI YOLO defaults apply to future new TUI sessions in every directory.
Subscription adapters remain experimental and are not verified provider-approved integrations. macOS binaries remain unsigned and not notarized.
Validation
Release publication is gated on builds, workspace tests, Clippy, installer tests, and Linux terminal smoke tests across the four supported targets. The main-branch CI also checks the declared minimum Rust version. Tests exercise socket permissions, request bounds, disconnect behavior, cleanup, and shutdown acknowledgements, as well as RPC approvals, steering, cancellation, MCP/code mode, and provider retries. Live subscription authentication/inference is not validated; the live Ollama test is ignored by default.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shThe default destination...
Habibi v0.5.0
Habibi v0.5.0
A more terminal-like prompt editor and a folder-scoped session browser.
- Session picker:
/resumeopens a searchable, newest-first list for the current folder, with original first-user/latest-message previews. Arrow keys or wheel select, Enter resumes, Esc closes. Narrow terminals stack the panes. Browsing is read-only; locked/invalid sessions leave the current session intact. Saved model and permissions are restored, and local control clients must rediscover the new socket. Preview/file-count limits are documented in the README. - Safer Ctrl-C: clears a nonempty draft first, without quitting or interrupting the agent. With an empty prompt it cancels an active run or quits when idle. Esc still interrupts immediately.
- Editable prompt history: Up/Down or Ctrl-P/N browses up to 100 submitted prompts, including queued messages and commands. Down past the newest restores the unfinished draft and cursor. Available user messages seed history on resume. Autocomplete retains Up/Down priority while open; Ctrl-N retains approval-denial priority.
- Terminal editing: Ctrl-A/E or Home/End for line boundaries; Ctrl-B/F for characters; Alt-B/F or Ctrl/Alt-arrow keys for words; Ctrl-W and Alt-D for word deletion; Ctrl-K for deleting to line end; Ctrl-D/H for delete/backspace. Ctrl-U still clears the whole draft. Unicode character boundaries are preserved.
- Select and copy: mouse scrolling remains enabled, with no
/mousecommand. Use your terminal's selection override (commonly Shift-drag), then its copy shortcut. Ctrl-C is not copy. Selection remains terminal-owned, not a whole-session export.
Existing configuration and session journals remain compatible. No new global history file is written. Terminal modifier support varies. macOS binaries remain unsigned and not notarized.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi after upgrading.
Habibi v0.4.1
MCP OAuth from the terminal UI and CLI.
What's new
- Authenticate from
/mcp: select a saved HTTP server and press a. Browser authorization runs without blocking the terminal; the dialog shows a fallback link and accepts a privately pasted full callback URL. Esc or Ctrl-C cancels. Press l to remove local credentials. The server list shows saved OAuth versus explicit bearer authentication. - CLI authentication:
habibi mcp login|status|logout SERVER, with login options--client-id, repeatable--scope, and--callback-portfor pre-registered public clients. - Automatic refresh: Streamable HTTP connections use endpoint-bound saved OAuth when no bearer environment variable is configured. Expired tokens refresh through the MCP SDK, with cross-process locking and atomic private credential storage.
- Protocol protections: discovery, S256 PKCE, callback state/origin/duplicate-parameter checks, issuer binding on every credential read, and bounded callback input. Provider response bodies are not exposed through OAuth/transport error messages.
- Library opt-in:
mcp_oauth::{Store, Login, LoginOptions}andmcp::connect_with_oauth_store; existing callers ofmcp::connectkeep their previous behavior.
Compatibility and limits
Existing server configuration and journals remain compatible. Explicit bearer-env configuration takes precedence. OAuth requires published metadata with an issuer and a public client (dynamic registration or a supplied client ID); confidential clients and legacy HTTP+SSE are not supported. Login never starts automatically from a model/tool request. Credentials live in private files, not an encrypted keychain. Logout deletes local credentials, not provider grants, and cannot recall in-flight requests. macOS binaries remain unsigned and not notarized.
Validation
Hermetic tests exercise discovery, dynamic/public registration, PKCE token exchange, loopback callbacks, automatic refresh during MCP initialization, issuer changes, endpoint isolation, logout, cancellation/denial, file permissions, lock contention, and hidden UI input. Full workspace tests, Clippy, Rust 1.89 compatibility, installer checks, and terminal smoke tests run before release. Live third-party OAuth accounts have not been tested.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi, open /mcp, select a saved HTTP server with no bearer environment field, and press a.
Habibi v0.4.0
Local agent control, headless workflows, MCP, and embedded code mode.
What's new
- Control any running instance: the TUI,
-p, and--rpceach expose a private Unix socket. Send JSON Lines requests for status, prompts, steering, follow-ups, approvals, stop, and shutdown without taking over the terminal. Startup output shows the path; discovery metadata identifies the process and session. Client disconnects leave work running. - Headless and stdio RPC:
habibi -p "…"streams text and exits;habibi --rpcserves a persistent event/request protocol. Explicit--yolois required for headless auto-approval regardless of saved TUI preferences. Stdio RPC supports individual tool approvals. - MCP integration and editor: connect trusted stdio and Streamable HTTP servers from user configuration.
/mcpoffers forms for server arguments, environment references, URLs, enable/disable, and removal, with atomic saves and external-change detection. Connections start on the first prompt; repository MCP configuration is never loaded. - Embedded code mode: QuickJS scripts compose registered tools with bounded parallelism, output, execution time, and memory. Child calls retain individual Ask/YOLO approvals and audit records. No external JavaScript runtime is required.
- Extensible library tools: register custom tools with validated input schemas and connect MCP servers through
libhabibi. - Transient provider retries: Codex, Claude, and Ollama retry connection failures, timeouts, and selected transient HTTP errors up to five times with cancellable backoff. Partial streams are not retried; tool calls are not replayed.
- Command and skill completion: a five-row list above the prompt includes discovered
/skill:nameentries. Up/Down selects, Tab completes, and partial matches can be accepted with Enter. Loading skill bodies remains approval-gated. - Documentation and GitHub Pages: updated getting-started guidance, release information, and the local RPC protocol reference.
Compatibility and safety
Existing journals remain readable. Journals containing new code-mode child-call audit records require v0.4.0 or later; older binaries cannot read those records. MCP/code-mode preferences persist in sessions and user defaults; both features are enabled by default. MCP programs run only when explicitly configured, but starting configured programs does not require a tool approval.
Socket directories are created with mode 0700 and sockets with mode 0600. Other processes running as your user can control the agent, including approving tools. Socket transport is request/reply only, not an event stream. Plain -p remains one-shot and denies tools unless --yolo is explicit. Normal exit removes discovery files; forced termination may leave stale entries.
Tool approval is not sandboxing: shell commands and MCP programs retain your account's filesystem/network access. Code-mode limits do not restrict the capabilities of approved tools. Cancellation cannot undo completed local or remote side effects. Saved TUI YOLO defaults apply to future new TUI sessions in every directory.
Subscription adapters remain experimental and are not verified provider-approved integrations. macOS binaries remain unsigned and not notarized.
Validation
Release publication is gated on builds, workspace tests, Clippy, installer tests, and Linux terminal smoke tests across the four supported targets. The main-branch CI also checks the declared minimum Rust version. Tests exercise socket permissions, request bounds, disconnect behavior, cleanup, and shutdown acknowledgements, as well as RPC approvals, steering, cancellation, MCP/code mode, and provider retries. Live subscription authentication/inference is not validated; the live Ollama test is ignored by default.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shThe default destination is ~/.local/bin. Restart Habibi after upgrading. To pin this release:
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | HABIBI_VERSION=v0.4.0 shReview the installer before running remote shell code. Checksums detect corruption; they are not independent publisher signatures.
Habibi v0.4.1
Habibi v0.4.1
MCP OAuth from the terminal UI and CLI.
What's new
- Authenticate from
/mcp: select a saved HTTP server and press a. Browser authorization runs without blocking the terminal; the dialog shows a fallback link and accepts a privately pasted full callback URL. Esc or Ctrl-C cancels. Press l to remove local credentials. The server list shows saved OAuth versus explicit bearer authentication. - CLI authentication:
habibi mcp login|status|logout SERVER, with login options--client-id, repeatable--scope, and--callback-portfor pre-registered public clients. - Automatic refresh: Streamable HTTP connections use endpoint-bound saved OAuth when no bearer environment variable is configured. Expired tokens refresh through the MCP SDK, with cross-process locking and atomic private credential storage.
- Protocol protections: discovery, S256 PKCE, callback state/origin/duplicate-parameter checks, issuer binding on every credential read, and bounded callback input. Provider response bodies are not exposed through OAuth/transport error messages.
- Library opt-in:
mcp_oauth::{Store, Login, LoginOptions}andmcp::connect_with_oauth_store; existing callers ofmcp::connectkeep their previous behavior.
Compatibility and limits
Existing server configuration and journals remain compatible. Explicit bearer-env configuration takes precedence. OAuth requires published metadata with an issuer and a public client (dynamic registration or a supplied client ID); confidential clients and legacy HTTP+SSE are not supported. Login never starts automatically from a model/tool request. Credentials live in private files, not an encrypted keychain. Logout deletes local credentials, not provider grants, and cannot recall in-flight requests. macOS binaries remain unsigned and not notarized.
Validation
Hermetic tests exercise discovery, dynamic/public registration, PKCE token exchange, loopback callbacks, automatic refresh during MCP initialization, issuer changes, endpoint isolation, logout, cancellation/denial, file permissions, lock contention, and hidden UI input. Full workspace tests, Clippy, Rust 1.89 compatibility, installer checks, and terminal smoke tests run before release. Live third-party OAuth accounts have not been tested.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shRestart Habibi, open /mcp, select a saved HTTP server with no bearer environment field, and press a.
Habibi v0.4.0
Local agent control, headless workflows, MCP, and embedded code mode.
What's new
- Control any running instance: the TUI,
-p, and--rpceach expose a private Unix socket. Send JSON Lines requests for status, prompts, steering, follow-ups, approvals, stop, and shutdown without taking over the terminal. Startup output shows the path; discovery metadata identifies the process and session. Client disconnects leave work running. - Headless and stdio RPC:
habibi -p "…"streams text and exits;habibi --rpcserves a persistent event/request protocol. Explicit--yolois required for headless auto-approval regardless of saved TUI preferences. Stdio RPC supports individual tool approvals. - MCP integration and editor: connect trusted stdio and Streamable HTTP servers from user configuration.
/mcpoffers forms for server arguments, environment references, URLs, enable/disable, and removal, with atomic saves and external-change detection. Connections start on the first prompt; repository MCP configuration is never loaded. - Embedded code mode: QuickJS scripts compose registered tools with bounded parallelism, output, execution time, and memory. Child calls retain individual Ask/YOLO approvals and audit records. No external JavaScript runtime is required.
- Extensible library tools: register custom tools with validated input schemas and connect MCP servers through
libhabibi. - Transient provider retries: Codex, Claude, and Ollama retry connection failures, timeouts, and selected transient HTTP errors up to five times with cancellable backoff. Partial streams are not retried; tool calls are not replayed.
- Command and skill completion: a five-row list above the prompt includes discovered
/skill:nameentries. Up/Down selects, Tab completes, and partial matches can be accepted with Enter. Loading skill bodies remains approval-gated. - Documentation and GitHub Pages: updated getting-started guidance, release information, and the local RPC protocol reference.
Compatibility and safety
Existing journals remain readable. Journals containing new code-mode child-call audit records require v0.4.0 or later; older binaries cannot read those records. MCP/code-mode preferences persist in sessions and user defaults; both features are enabled by default. MCP programs run only when explicitly configured, but starting configured programs does not require a tool approval.
Socket directories are created with mode 0700 and sockets with mode 0600. Other processes running as your user can control the agent, including approving tools. Socket transport is request/reply only, not an event stream. Plain -p remains one-shot and denies tools unless --yolo is explicit. Normal exit removes discovery files; forced termination may leave stale entries.
Tool approval is not sandboxing: shell commands and MCP programs retain your account's filesystem/network access. Code-mode limits do not restrict the capabilities of approved tools. Cancellation cannot undo completed local or remote side effects. Saved TUI YOLO defaults apply to future new TUI sessions in every directory.
Subscription adapters remain experimental and are not verified provider-approved integrations. macOS binaries remain unsigned and not notarized.
Validation
Release publication is gated on builds, workspace tests, Clippy, installer tests, and Linux terminal smoke tests across the four supported targets. The main-branch CI also checks the declared minimum Rust version. Tests exercise socket permissions, request bounds, disconnect behavior, cleanup, and shutdown acknowledgements, as well as RPC approvals, steering, cancellation, MCP/code mode, and provider retries. Live subscription authentication/inference is not validated; the live Ollama test is ignored by default.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shThe default destination is ~/.local/bin. Restart Habibi after upgrading. To pin this release:
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | HABIBI_VERSION=v0.4.0 shReview the installer before running remote shell code. Checksums detect corruption; they are not independent publisher signatures.
Habibi v0.4.0
Habibi v0.4.0
Local agent control, headless workflows, MCP, and embedded code mode.
What's new
- Control any running instance: the TUI,
-p, and--rpceach expose a private Unix socket. Send JSON Lines requests for status, prompts, steering, follow-ups, approvals, stop, and shutdown without taking over the terminal. Startup output shows the path; discovery metadata identifies the process and session. Client disconnects leave work running. - Headless and stdio RPC:
habibi -p "…"streams text and exits;habibi --rpcserves a persistent event/request protocol. Explicit--yolois required for headless auto-approval regardless of saved TUI preferences. Stdio RPC supports individual tool approvals. - MCP integration and editor: connect trusted stdio and Streamable HTTP servers from user configuration.
/mcpoffers forms for server arguments, environment references, URLs, enable/disable, and removal, with atomic saves and external-change detection. Connections start on the first prompt; repository MCP configuration is never loaded. - Embedded code mode: QuickJS scripts compose registered tools with bounded parallelism, output, execution time, and memory. Child calls retain individual Ask/YOLO approvals and audit records. No external JavaScript runtime is required.
- Extensible library tools: register custom tools with validated input schemas and connect MCP servers through
libhabibi. - Transient provider retries: Codex, Claude, and Ollama retry connection failures, timeouts, and selected transient HTTP errors up to five times with cancellable backoff. Partial streams are not retried; tool calls are not replayed.
- Command and skill completion: a five-row list above the prompt includes discovered
/skill:nameentries. Up/Down selects, Tab completes, and partial matches can be accepted with Enter. Loading skill bodies remains approval-gated. - Documentation and GitHub Pages: updated getting-started guidance, release information, and the local RPC protocol reference.
Compatibility and safety
Existing journals remain readable. Journals containing new code-mode child-call audit records require v0.4.0 or later; older binaries cannot read those records. MCP/code-mode preferences persist in sessions and user defaults; both features are enabled by default. MCP programs run only when explicitly configured, but starting configured programs does not require a tool approval.
Socket directories are created with mode 0700 and sockets with mode 0600. Other processes running as your user can control the agent, including approving tools. Socket transport is request/reply only, not an event stream. Plain -p remains one-shot and denies tools unless --yolo is explicit. Normal exit removes discovery files; forced termination may leave stale entries.
Tool approval is not sandboxing: shell commands and MCP programs retain your account's filesystem/network access. Code-mode limits do not restrict the capabilities of approved tools. Cancellation cannot undo completed local or remote side effects. Saved TUI YOLO defaults apply to future new TUI sessions in every directory.
Subscription adapters remain experimental and are not verified provider-approved integrations. macOS binaries remain unsigned and not notarized.
Validation
Release publication is gated on builds, workspace tests, Clippy, installer tests, and Linux terminal smoke tests across the four supported targets. The main-branch CI also checks the declared minimum Rust version. Tests exercise socket permissions, request bounds, disconnect behavior, cleanup, and shutdown acknowledgements, as well as RPC approvals, steering, cancellation, MCP/code mode, and provider retries. Live subscription authentication/inference is not validated; the live Ollama test is ignored by default.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shThe default destination is ~/.local/bin. Restart Habibi after upgrading. To pin this release:
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | HABIBI_VERSION=v0.4.0 shReview the installer before running remote shell code. Checksums detect corruption; they are not independent publisher signatures.
Habibi v0.3.1
Habibi v0.3.1
Slash commands without interrupting the agent, plus command suggestions and Tab completion.
What's new
- Commands during execution:
/inspect,/settings,/model,/models,/help, and/updateremain available while the agent runs. Commands are handled locally, not sent as steering messages. - Slash-command suggestions: type
/to see matching commands. Press Tab to complete the first match and keep pressing to cycle through matches. Suggestions narrow as you type. - Inspection during execution: browse the latest read-only context-boundary snapshot while the agent continues working. Close and reopen the inspector to refresh. Inspection never executes or approves tools.
- Deferred settings: model and settings changes saved during execution apply after the current run finishes, before queued follow-ups. In-flight requests and current tool permissions remain unchanged, including Ask/YOLO policy. User defaults are saved when the changes are applied.
- Documentation and website: refreshed command guidance and GitHub Pages release information.
Compatibility and safety
Existing journals and user defaults remain compatible. /compact, /quit, and /exit still require an idle agent; Esc interrupts a run. Closing an inspector or settings dialog does not cancel the run. The inspector is a snapshot, not a continuously updating view.
Subscription adapters remain experimental and are not provider-approved integrations. Tool approval is not sandboxing: shell commands retain your account's filesystem and network access. Explicitly enabling YOLO also saves that preference for future new sessions in every directory. macOS binaries remain unsigned and not notarized.
Validation
Workspace tests cover slash-command matching and read-only inspection snapshots, alongside the existing provider, approval, steering, compaction, resume, settings, and terminal-status tests. The live Ollama test requires an external server and is skipped by default. Release publication is gated on the four-platform build/test workflow. Live subscription authentication and inference are not verified by these checks.
Install or upgrade
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shThe default destination is ~/.local/bin. Restart Habibi after upgrading. To pin this release:
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | HABIBI_VERSION=v0.3.1 shReview the installer before running remote shell code. Checksums detect corruption; they are not independent publisher signatures.
Habibi v0.3.0
Habibi v0.3.0
Local Ollama, refreshed subscription choices, persistent defaults, and terminal status integration.
What's new
- Ollama provider: native streaming chat and tool calls with the usual approval, steering, compaction, cancellation, and session-resume behavior. No OAuth, no automatic model downloads, and no subscription credentials sent to Ollama. Start with
habibi --provider ollama --model qwen3:8bafter installing the model yourself. - Model discovery and selection:
habibi modelslists bundled subscription choices;habibi models ollamalists installed Ollama models./modelsdoes the same for the active provider, and Ctrl-N/P in/modelcycles choices. Custom IDs remain supported. - Subscription model refresh: new-install defaults are
gpt-6.1-solfor Codex andclaude-sonnet-5-5for Claude. Bundled alternatives include the current GPT-6.1/GPT-6/GPT-5.6 ChatGPT OAuth choices and Claude Opus/Sonnet/Haiku 5.5 plus Fable 5.2. The snapshot was checked on 2026-11-11; account access varies. Existing saved model IDs are preserved. No hosted catalog or automatic catalog refresh. - Persistent user defaults: applying
/modelsaves a model per provider and the preferred provider. Applying/settingsalso saves frontend preferences, including explicitly enabled YOLO, for new sessions in every directory. Stored privately at$XDG_CONFIG_HOME/habibi/settings.jsonor~/.config/habibi/settings.json. CLI overrides do not rewrite defaults; resumed sessions keep their journaled settings. - Program Status Protocol: OSC 7501 reports idle, working, permission/authentication blocked, done, error, and cancellation states for Rex and other supporting terminals. Messages are fixed and contain no prompts, arguments, paths, credentials, or provider error details. Duplicate states are suppressed. Set
HABIBI_NO_PROGRAM_STATUS=1to disable.
Compatibility and safety
Old journals remain readable. Ollama journals require v0.3.0 or later. New sessions use user defaults; resumed sessions retain their own model, endpoint, and permission policy. Context/turn/skill settings remain session-local. Applying /model alone never promotes an old session's permission mode to global defaults.
Enabling YOLO in /settings now also enables it for future new sessions in every directory. The confirmation explicitly warns about this scope. Disable it and Apply to restore Ask for future sessions. Existing journals keep their saved permission mode and must be changed separately. YOLO auto-approves all tools, including unsandboxed shell commands.
Remote Ollama endpoints receive conversation and workspace content. Use only trusted servers and HTTPS outside trusted local networks. Authenticated Ollama servers are not supported.
Validation
Offline tests cover all three providers' tool loops, approval/denial, steering, compaction, native history, and resume; Ollama framing is tested across arbitrary UTF-8 chunk boundaries. A live local qwen3:8b read-tool round trip passed. OSC 7501 wire format, state mapping, deduplication, opt-out behavior, and private-data exclusion have unit coverage. An end-to-end pseudo-terminal test verified idle → working → blocked for tool approval → working → done → idle against an Ollama fixture server.
Live subscription authentication/inference and Rex's UI presentation have not been verified. Catalog references establish documented model IDs, not provider approval or guaranteed subscription access. See provider notes.
Install
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shThe default destination is ~/.local/bin. Add it to PATH if prompted. After this release is published, pin it with HABIBI_VERSION=v0.3.0 on the sh side of the pipe.
Important limitations
Subscription adapters remain experimental and are not provider-approved integrations. Claude compatibility uses Claude Code-specific identity. There is no API-billing fallback. Review provider terms.
Tool approval is not sandboxing. Shell commands have your account's filesystem/network access. Sessions, user defaults, and credentials are plaintext files. macOS binaries are unsigned and not notarized. Updates are opt-in to install, never automatic. Checksums detect corruption; they are not independent signatures.
Habibi v0.2.0
Habibi v0.2.0
Agent Skills, inspectable context, and a more usable native coding loop.
What's new
- Agent Skills discovery from configurable directories, defaulting to
~/.agentsand workspace.agents, including theirskills/subdirectories. Frontmatter is added to context automatically; the approval-gatedload_skilltool reads full instructions on demand. - Sticky skills enabled by default: approved snapshots survive compaction and resume. Toggle sticky mode and edit the directory list in
/settings; repeated--skill-diroptions override the defaults for new sessions. /inspectread-only modal with searchable Context and Tool calls tabs. Browse active context and byte-budget breakdowns, tool arguments/results/errors, and latest/all session calls—even across compaction and resume.- Manual
/compactand automatic context summarization (80% of the byte budget by default; 0 disables it). Original journal history is retained; failed/cancelled compaction leaves active context unchanged. - Bouncing-ball activity indicator in the prompt border for thinking, responses, tools, and compaction, without a duplicate Thinking footer label.
- Unlimited model turns by default. Set a positive cap in
/settings, or use 0 for unlimited; existing sessions keep their saved cap. - Saved YOLO mode automatically becomes active on session resume without repeated confirmation. New sessions still default to Ask, and initially enabling YOLO requires confirmation. YOLO auto-approves every tool, including unsandboxed shell commands.
Compatibility
Existing session journals remain readable. New settings and tool-history checkpoints are written by this version; use v0.2.0 or later to resume journals updated by this release. Settings are session-local, not global preferences.
Install
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shThe default destination is ~/.local/bin. Add it to your PATH if prompted.
To pin this release, set HABIBI_VERSION=v0.2.0 on the sh side of the pipe.
Important limitations
Subscription adapters remain experimental: real-account authentication/inference has not been verified for this prototype. They are not provider-approved integrations, and there is no API-billing fallback. Claude compatibility uses Claude Code-specific identity. Review provider terms.
Tool approval is not sandboxing. Shell commands have your account's filesystem/network access. Sessions and credentials are plaintext files. YOLO auto-approves all tools and remains active after session resume until disabled in /settings.
macOS binaries are currently unsigned and not notarized. Updates are opt-in to install, never automatic. Release checksums detect corruption; they are not independent signatures.
Habibi v0.1.0
Habibi v0.1.0
First experimental release of Habibi, a native Rust coding agent and reusable library.
- Direct Codex and Claude subscription adapters with OAuth PKCE and hidden remote callback input.
- Full-screen terminal UI with styled conversations, compact tool summaries, scrolling, and multiline input.
- Live steering, queued follow-ups, cancellation, and recoverable/resumable JSONL sessions.
/model,/settings, configurable status bar, process RAM and context-budget readouts.- Ask-per-tool permissions by default; explicit, reconfirmed YOLO auto-approval option.
- Linux x86-64/ARM64 static musl builds and macOS Intel/Apple Silicon builds.
- Checksum-verified, no-sudo installer and a best-effort background update notice.
Install
curl -fsSL https://habibiailabs.github.io/habibi-code/install.sh | shThe default destination is ~/.local/bin. Add it to your PATH if prompted.
To pin this release, set HABIBI_VERSION=v0.1.0 on the sh side of the pipe.
Important limitations
Subscription adapters remain experimental: real-account authentication/inference has not been verified for this prototype. They are not provider-approved integrations, and there is no API-billing fallback. Claude compatibility uses Claude Code-specific identity. Review provider terms.
Tool approval is not sandboxing. Shell commands have your account's filesystem/network access. Sessions and credentials are plaintext files. YOLO auto-approves all tools and must be explicitly reconfirmed after resume.
macOS binaries are currently unsigned and not notarized. Updates are opt-in to install, never automatic. Release checksums detect corruption; they are not independent signatures.