DEV Community: 涼風羽月

LibreFang 2026.7.10 Released

涼風羽月 — Fri, 10 Jul 2026 10:39:58 +0000

LibreFang 2026.7.10 Released

This release unlocks extended thinking for reasoning models, improves Slack formatting, eliminates redundant artifact output, and expands international reach. Alongside that, we've locked down security advisories and made your test suites faster and more reliable.

39 PRs from 4 contributors since v2026.6.29.

What's New

🧠 Extended Thinking & Reasoning Support

The OpenAI-compatible driver now correctly forwards reasoning_effort to supported models, unlocking extended thinking and o1-style reasoning flows. If you're using Claude, o1, or other reasoning-enabled models, this is a substantial unlock for complex problem-solving agents that need to think deeply before acting.

💬 Native Slack Message Formatting

Markdown messages sent to Slack are now automatically converted to Slack's native mrkdwn format in the Slack sidecar. Your Slack agents now produce properly-formatted, native-looking messages instead of raw Markdown syntax — a small change that makes a big difference in readability.

🎯 Smarter Output Deduplication

Artifact read results are no longer re-spilled at the post-tool chokepoint, eliminating redundant output and keeping agent conversations cleaner. This is especially valuable in longer runs where output verbosity can distract from the actual work.

🔍 Dashboard Model Transparency

The Codex CLI now exposes which model it's configured to run, visible directly in the dashboard. No more mystery about what's powering your agents.

🌍 Internationalization

Dashboard and website translations have been completed and proofread across multiple languages, opening LibreFang to a global community of developers.

🛡️ Security & Reliability Hardening

Tests can now run offline with LIBREFANG_REGISTRY_OFFLINE, removing network dependencies and accelerating your CI pipelines
Multiple security advisories cleared: quick-xml, crossbeam-epoch, and cargo-deny all updated
WS terminal frames now correctly correlate with chat turns, improving observability and debugging
Fixed edge cases in media handling and TUI formatting for smoother operation

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk

LibreFang 2026.6.29 Released

涼風羽月 — Mon, 29 Jun 2026 07:00:20 +0000

LibreFang 2026.6.29 Released

This release marks three major engineering priorities: bringing LibreFang to global audiences, expanding hardware support, and squashing critical reliability edge cases. 14 PRs from 4 contributors landed since v2026.6.26-beta.24.

What's New

🌍 Full Korean Language Support

We've shipped complete Korean translations across the entire stack:

UI: 233 language keys translated
CLI/TUI: Commands and help text in Korean
Error messages: Expanded from 43 to 233 localized keys

Korean-speaking developers and teams can now use LibreFang entirely in their language.

🏗️ Multiplatform: ARM64 Linux & Android Ready

aarch64 Linux is now fully supported:

Official ARM64 binaries published to AUR and the project-maintained pacman repository alongside x86_64
Android NDK cross-compilation fixed (legacy binutils symlink + PATH resolution)

Deploy confidently on Raspberry Pi, Apple Silicon Linux containers, cloud ARM instances, and Android environments.

🛡️ Reliability Fixes & Security

Mixed-media message batches — edge case fixed where coalesced batches with mixed content types weren't enriched on the debounced path
Telegram setup form resilience — stays available even if the describe call times out, preventing users from getting stuck mid-setup
Security patch — bumped pdf-extract to 0.12 to patch RUSTSEC-2026-0187 (lopdf vulnerability)

⚡ Developer Experience

Codex CLI now works outside Git repositories — remove the requirement to run inside a .git tree. Perfect for standalone scripts, CI pipelines, and one-off analysis.

Changes at a Glance

Category	Changes
Internationalization	Korean UI (#6349), Korean errors (#6353), Korean CLI/TUI (#6356)
Multiplatform	aarch64 packages (#6358), NDK binutils fix (#6335), NDK PATH fix (#6338)
Reliability	Telegram setup (#6345), mixed-media enrichment (#6351), security patch (#6339)
Developer Tools	Codex CLI outside Git (#6347)
Operations	AUR automation (#6341), pacman repo to R2 (#6352), CI improvements (#6340, #6346)

Detailed changelog

Added

UI Korean translation (#6349) (@seungjin)
Complete Korean error translations (43 → 233 keys) (#6353) (@houko)
Add Korean (ko) translation for the CLI/TUI (#6356) (@houko)
Publish aarch64 packages alongside x86_64 (#6334) (#6358) (@houko)

Fixed

Bump pdf-extract 0.10→0.12 to patch lopdf RUSTSEC-2026-0187 (#6339) (@houko)
Keep Telegram setup form available after describe timeout (#6345) (@pavver)
Allow Codex CLI outside Git repositories (#6347) (@pavver)
Enrich coalesced mixed-media batches on the debounced path (#6348) (#6351) (@houko)

Maintenance

Symlink legacy NDK binutils so vendored OpenSSL cross-compiles for Android (#6335) (@houko)
Put NDK bin on PATH so openssl-src finds the legacy ranlib symlink (#6338) (@houko)
Enable auto-merge instead of forcing --admin (#6340) (@houko)
Publish AUR packages on release (#6334) (#6341) (@houko)
Publish project-maintained pacman repo to R2 (#6334) (#6352) (@houko)
Fix[flake.nix]: Add perl to nativeBuildInputs (#6346) (@FrantaNautilus)

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk

LibreFang 2026.4.27 Released

涼風羽月 — Mon, 04 May 2026 13:14:41 +0000

LibreFang 2026.4.27 Released

LibreFang v2026.4.27 ships the changes below. See the full changelog for the complete list.

Added

TUI setup wizard now offers microsoft, zai, zai_coding, volcengine, volcengine_coding, byteplus, byteplus_coding alongside the existing first-run options. The wizard's PROVIDERS list had drifted from PROVIDER_REGISTRY and silently hid these from new installs; a unit test now pins these entries against future regressions. (@houko)
Treat CLI logins as first-class default providers (#3061) (@houko)
Grafana Tempo + business-level span instrumentation (#3064) (@houko)
/new creates a new session instead of resetting the current one (#3071) (@neo-wanderer)
Support image-generation models (registry modality field) (#3074) (@houko)
Wire chat attachment uploads in ChatPage (#3075) (@houko)
Add Novita AI as OpenAI-compatible provider (#3076) (@houko)
Agent name prefix on outbound + Signal plain-text default (#3077) (@houko)
SSE attach endpoint for multi-client session co-watching (#3078) (@houko)
Add SearXNG self-hosted search provider (#3079) (@houko)
Add AWS Bedrock provider with Bearer token auth (#3080) (@houko)
AuditCheck framework + first 3 CLAUDE.md gotcha checks (#3082) (@houko)
Add LlmFamily enum + LlmDriver::family() (#3083) (@houko)
SSE attach hook for multi-client session co-watching (#3087) (@houko)
Add ToolApprovalClass + tool_classifier (no behavior change yet) (#3092) (@houko)
Session lifecycle event bus (additive, no subscribers yet) (#3093) (@houko)
Support PDF and text/code file attachments end-to-end (#3094) (@houko)
Trajectory export endpoint with privacy redaction (#3097) (@houko)
Extend detect_embedding_provider with vLLM + LM Studio fallback (#3099) (@houko)
Cron multi-destination delivery with failure isolation (#3102) (@houko)
UI for cron multi-destination delivery targets (#3103) (@houko)
Cache /config + reject pageno=0 + annotate truncation (#3108) (@houko)
Re-read agent context.md per turn (#3115) (@houko)
Central slash command registry (PR-1/3) (#3122) (@houko)
Slash command registry — CLI/TUI surface (PR-2/3) (#3123) (@houko)
Configurable max history messages (per-agent + global override) (#3125) (@neo-wanderer)
System_and_3 prompt cache stamping for Anthropic (M1) (#3126) (@houko)
ParallelSafety projection for batch tool dispatch (PR-1/6) (#3127) (@houko)
Plan_batch + path-overlap planner for tool dispatch (PR-2/6) (#3129) (@houko)
Model metadata lookup pipeline (PR-1/3, layers 1+2+5) (#3133) (@houko)
Model metadata L3 cache + L4 Ollama probe (PR-2/3) (#3134) (@houko)
Model metadata L4 Anthropic + OpenAI-compat probes (PR-2.5/3) (#3140) (@houko)
KernelConfig.parallel_tools section (PR-3/6) (#3144) (@houko)
Cron pre_script + silent_marker schema (PR-1/3) (#3145) (@houko)
Cache_hit_ratio metric + trajectory field (M2/2) (#3149) (@houko)
Agent detail drawer + filter pill i18n (#3159) (@houko)
Right-side drawer pattern for inspect-detail surfaces (#3166) (@houko)
Convert hand detail panel to drawer variant (#3168) (@houko)
Roll out drawer/panel pattern across all page modals (#3175) (@houko)
Add Jaeger as second trace backend alongside Tempo (#3176) (@houko)
Granular MCP taint policy + dashboard tree editor (closes #3050) (#3193) (@houko)
Jaeger trace backend + Loki/Alloy logs + CLI wiring (#3194) (@houko)
Per-(agent, session) liveness tracking and session-scoped stop (#3195) (@houko)
RBAC M2 — audit user/channel attribution + stable UserId (#3054) (#3196) (@houko)
Hot-reload log_level via dashboard without daemon restart (#3200) (@houko)
RBAC M4 — channel-native role mapping (Telegram/Discord/Slack) (#3054) (#3202) (@houko)
RBAC M5 — audit query/export + per-user budget API (#3054) (#3203) (@houko)
RBAC M3 — per-user tool policy + memory namespace ACL (#3054) (#3205) (@houko)
RBAC M6 — dashboard (users, identity linking, simulator, CSV import + stubs) (#3054) (#3209) (@houko)
Per-agent + global lane caps for trigger dispatch (#3210) (@neo-wanderer)
Auto-download voice messages mirroring file path (#3212) (@neo-wanderer)
Wip (#3213) (@houko)
Hand agent runtime overrides with restart persistence (#3216) (@leszek3737)
Deliver HealthCheckFailed to notification.alert_channels (#3218) (@neo-wanderer)
Per-user budget write/clear endpoints + dashboard editor (#3224) (@houko)
Activate AuditPage now that M5 audit endpoints shipped (#3225) (@houko)
Per-action retention policy with chain-anchor trim (#3227) (@houko)
RBAC effective-permissions snapshot — wire simulator (#3054) (#3228) (@houko)
RBAC M3 — per-user policy GET/PUT + dashboard editor (#3229) (@houko)
RBAC — single-decision authz/check endpoint (#3054) (#3231) (@houko)
User-list summary flags + custom channel rule editor (#3229 follow-up) (#3232) (@houko)
Owner-only API key rotation with live session kill (#3233) (@houko)
External mount points in agent.toml (#3230) (#3234) (@houko)
Channel field as dynamic dropdown with custom fallback (#3248) (@houko)
URL-synced filters, JSON export, row detail modal (#3252) (@houko)
Move filters into right-docked drawer (#3254) (@houko)
BeforePromptBuild hook can contribute labeled DynamicSection injected into the system prompt, with 8KiB per-section / 32KiB total caps (closes #3326) (#3358) (@houko)

Fixed

Reconnect WhatsApp gateway after transient disconnects (#21) (@houko)
Render connection screen via custom URI scheme (closes #3052) (#3056) (@houko)
Create log dir + open log before stdout redirect (#3057) (@houko)
Surface CLI logins as their own providers, not API-provider fallbacks (#3059) (@houko)
Pre-create logs dir in entrypoint (defense for #3058) (#3060) (@houko)
Bundle compose stack in-binary, add OTLP collector (#3062) (@houko)
Create HTTP trace spans at INFO so OTel exporter sees them (#3063) (@houko)
Move env_filter to fmt layer so OTel sees INFO spans (#3065) (@houko)
Drop ingester/compactor from Tempo config (#3067) (@houko)
Boot-time TOML drift detection now reaches hand agents (#3068) (@neo-wanderer)
Reprobe local providers every 60s + refresh on test (#3069) (@houko)
Add missing files to src to fix librefang-cli build (#3073) (@FrantaNautilus)
Honor session_mode=new with per-fire isolated sessions (#3081) (@houko)
Copilot streaming empty tool calls + Claude assistant strip (#3084) (@houko)
Gemini array-items default + first-message-must-be-user (#3085) (@houko)
Safe UTF-8 boundary in three remaining truncation sites (#3086) (@houko)
PowerShell sandbox bypass + agent-config persistence + WS race + Revolt self-host (#3088) (@houko)
Cron preservation across hand reactivation + telegram startup timeout + token estimation includes ToolUse (#3090) (@houko)
Capture text from intermediate tool_use iterations (#3091) (@houko)
Percent-decode WS auth token to preserve base64 characters (#3095) (@houko)
Skip heartbeat timeout for agents in their idle grace window (#3096) (@houko)
Handle BrokenPipe gracefully in doctor --json (#3100) (@houko)
UTF-8-safe error truncation + 502/504 retry + response classify tests (#3104) (@houko)
Cap accumulated_text + document streaming non-redelivery contract (#3106) (@houko)
Cron dedupe + next_run + token_length annotation (#3109) (@houko)
Sticky has_processed_message replaces time-based grace (#3111) (@houko)
Use 127.0.0.1 instead of localhost for local LLM URLs (#3112) (@houko)
Pass agents_dir to hand route candidate scan to silence WARN flood (#3113) (@houko)
Close non-loopback auth bypass when api_key is empty (#3114) (@houko)
Downgrade pure-normalization to debug, keep WARN for real repair (#3117) (@houko)
Use "default" provider/model in custom-agent template (#3121) (@houko)
Forward api_key as Bearer in local provider probe (#3128) (@houko)
Degrade Memory page gracefully when proactive memory is disabled (#3131) (@houko)
Allow named workspaces in read-side path resolution (#3137) (@neo-wanderer)
Unbreak cron_delivery tests + move guards to input validation (#3139) (@houko)
Unbreak local provider config in GUI (#3141) (@houko)
Re-render hand [[settings]] tail after boot-time TOML drift (#3142) (@neo-wanderer)
Relax probe timeout for remote local-provider URLs (#3146) (@houko)
Preserve tool annotations for parallel safety classification (PR-6/6) (#3147) (@houko)
Include SearXNG in web_search_available check (#3152) (@houko)
Drop redundant runtime SSRF check in deliver_webhook (#3155) (@houko)
Add .desktop entry and install icon (#3157) (@FrantaNautilus)
Seed [[settings]] defaults into hand instance config on activation (#3160) (@houko)
Skip empty Blocks when stamping prompt cache markers (review fix for #3126) (#3161) (@houko)
Expose vLLM + LM Studio in embedding provider dropdown (refs #3138) (#3162) (@houko)
Re-render Reference Knowledge + Your Team tails after TOML drift (#3164) (@houko)
Provide .desktop entry and icon for librefang-desktop (#3156) (#3165) (@houko)
Regenerate config_schema golden after parallel_tools addition (#3167) (@houko)
Stop drawer scroll chaining into the page (#3169) (@houko)
Observability auto-start opt-in + home_dir isolation + RAII cleanup (#3170) (@houko)
Surface provider model list above the fold (#3179) (@houko)
Wire OS keyring (libsecret/Keychain/Credential Manager) (#3180) (@houko)
Wrap with wrapGAppsHook3 so tray icon resolves on NixOS (#3197) (@houko)
Probe OpenAI fallback for ollama-slot servers, hide non-discovered local models (#3204) (@houko)
Correct max_level_hint test assertions (#3206) (@houko)
Correct max_level_hint test assertions (#3207) (@houko)
Set sender_user_id metadata so RBAC works in groups (#3215) (@neo-wanderer)
Serialize channel config writes via toml_edit + lock (#3183) (#3223) (@houko)
Attribute loopback callers to user_api_keys when token provided (#3236) (@houko)
Invalidate effective-permissions on policy/budget mutations (#3228 follow-up) (#3237) (@houko)
Prefix sender_chat ids so they can't collide with user namespace (#3215 follow-up) (#3238) (@houko)
RBAC M3 follow-up — memory ACL fail-closed for anonymous callers (#3239) (@houko)
Include prev_hash so verifiers can replay the chain (#3203 follow-up) (#3240) (@houko)
RBAC M4 follow-up — role_cache reload + Telegram DM owner-escalation (#3241) (@houko)
Mark scope as user_policy_only to match implementation (#3231 follow-up) (#3242) (@houko)
Attribute admin actions to caller + log old->new diffs (#21 follow-up) (#3245) (@houko)
Harden CSV import + flag identity-link risk (#3209 follow-up) (#3246) (@houko)
RBAC M3 follow-up — namespace traversal + case-insensitive deny + memory audit emit (#3205) (#3249) (@houko)
Autonomous-loop tool calls bypass user gate (closes #3243) (#3251) (@houko)
Channel dropdown uses /api/channels for full 44-adapter list (#3253) (@houko)
Enforce deterministic ordering for LLM-bound MCP server / skill registries to stabilize provider prompt cache (closes #3298) (#3325) (@houko)

Changed

Derive JSON Schema from KernelConfig via schemars (#3055) (@houko)
Extract SessionStore trait alongside SQLite substrate (#3089) (@houko)
Make bridge helpers crate-private (#3181) (@houko)
Remove unused public helpers (#3182) (@houko)
Tighten visibility of internal request structs (#3184) (@houko)
Merge duplicate type definitions across crates (#3185) (@houko)
Rename Action enums to disambiguate from domain types (#3188) (@houko)
BREAKING: Split coding-provider API keys onto dedicated env vars — byteplus_coding now reads BYTEPLUS_CODING_API_KEY (was BYTEPLUS_API_KEY), volcengine_coding reads VOLCENGINE_CODING_API_KEY (was VOLCENGINE_API_KEY), zai_coding reads ZAI_CODING_API_KEY (was ZHIPU_API_KEY), zhipu_coding reads ZHIPU_CODING_API_KEY (was ZHIPU_API_KEY). Per-token siblings (byteplus, volcengine, zai, zhipu) keep their original env vars. Set the new env var if you use any _coding provider. (#3279) (@houko)
BREAKING: Register microsoft (GitHub Models / Azure AI Inference) as an explicit driver-registry entry with its own GITHUB_MODELS_TOKEN env var, distinct from github-copilot's GITHUB_TOKEN. Same PAT works for both, but the env vars are now separate so configuring one product no longer auto-activates the other in the model picker. Set GITHUB_MODELS_TOKEN if you use the microsoft provider. (#3281) (@houko)
BREAKING: Split zai from sharing ZHIPU_API_KEY with zhipu — zai (api.z.ai) now reads ZAI_API_KEY while zhipu (open.bigmodel.cn) keeps ZHIPU_API_KEY. Same Zhipu credential value works for both, but the env vars are now separate so configuring one no longer auto-activates the other. Set ZAI_API_KEY if you use the zai provider. (#3285) (@houko)

Documentation

Add tool_timeouts configuration documentation (#3098) (@leszek3737)
Backfill reference for cron / config / providers / channels / api / observability (#3189) (@houko)
Clarify worktree continuation drives to PR (#3190) (@houko)
Align left nav with file tree (#3199) (@houko)
Backfill source-vs-doc gaps (providers / channels — config / API / CLI to follow) (#3201) (@houko)
Drop HTML comment that broke Deploy Docs on main (#3208) (@houko)
Align Chinese translations with English source (#3220) (@houko)

Maintenance

Rename normalize_schema_recursive + warn on items fallback (#3105) (@houko)
Document apply_agent_prefix idempotency caveats (#3107) (@houko)
Timing-side-channel mitigation in percent_decode (#3110) (@houko)
Align localhost test expectations with #3112 default change (#3118) (@houko)
Ignore local .plans/ working notes directory (#3130) (@houko)
Sync librefang-types tracing dep into Cargo.lock (#3132) (@houko)
Unbreak main — cargo fmt for model_metadata.rs (#3150) (@houko)
Unbreak main — fix clippy manual_pattern_char_comparison (#3153) (@houko)
Hand-level skills propagation regression for #3135 (#3163) (@houko)
Pull librefang-api into selective lane on librefang-types changes (#3171) (@houko)
Drop LEGACY_TEAM_TAIL_MARKER fallback (#3177) (@houko)
Install libdbus-1-dev for OpenAPI Drift job (#3186) (@houko)
Remove unused dependencies across workspace (#3187) (@houko)
Pin push_notification routing for health_check_failed (#3222) (@houko)
Unbreak typecheck on sessions-stream test (#3235) (@houko)
Unbreak typecheck on UserBudgetPage + duplicate type export (#3244) (@houko)

Other

Unbreak main — use local user_api_keys snapshot (#3250) (@houko)

We just launched the new LibreFang website

涼風羽月 — Wed, 25 Mar 2026 08:13:52 +0000

We just shipped the new librefang.ai — a complete redesign of the official website for LibreFang, our open-source Agent Operating System built in Rust.

If you haven't heard of LibreFang: it's a production-grade runtime for autonomous AI agents. Single binary, 180ms cold start, 40MB memory. 15 built-in autonomous capability units ("Hands"), 44 channel adapters, 50 LLM providers. It runs agents 24/7 on a schedule — no user prompts needed.

Here's what we built for the new site.

7 languages, day one

The site ships with full translations in English, 简体中文, 繁體中文, 日本語, 한국어, Deutsch, and Español. Not machine-translated placeholders — every string was reviewed for grammar and natural phrasing.

Language detection is automatic based on your browser, and you can switch anytime from the nav.

Architecture visualized

The homepage walks through LibreFang's five-layer architecture:

Channels — 44 adapters: Telegram, Slack, Discord, WhatsApp, Signal, Matrix, Teams, and more
Hands — 15 autonomous units, each with its own model, tools, and workflow
Kernel — agent lifecycle, workflow orchestration, budget control, scheduling
Runtime — Tokio async, WASM sandbox, Merkle audit chain, SSRF protection
Hardware — runs everywhere: laptop, VPS, Raspberry Pi, bare metal

Each layer is interactive — click to explore the components inside.

Performance benchmarks, not marketing claims

We put a comparison table right on the homepage:

Metric	Others	LibreFang
Cold Start	2.5 ~ 4s	180ms
Idle Memory	180 ~ 250MB	40MB
Binary Size	100 ~ 200MB	32MB
Security Layers	2 ~ 3	16
Channel Adapters	8 ~ 15	44
Built-in Hands	0	15

Rust, not TypeScript. Production, not prototype.

One command install with OS detection

The install section detects your OS automatically and shows the right command:

macOS / Linux:

curl -fsSL https://librefang.ai/install | sh

Windows (PowerShell):

irm https://librefang.ai/install.ps1 | iex

Tabs let you switch between macOS, Windows, and Linux manually too.

Downloads & changelog

The downloads section pulls release data in real-time through our own API proxy. Desktop apps, CLI binaries, everything categorized by platform.

The changelog page shows a full timeline of releases with:

Category filters (features, fixes, etc.)
Download counts per asset
Auto-linked #issue references and @username mentions in release notes

Tech stack

React + TypeScript + Vite
Tailwind CSS for styling
Framer Motion for animations
TanStack Query for data fetching
Cloudflare Workers for the GitHub stats proxy

No heavy frameworks. No CMS. Just a fast SPA that gets out of your way.

What's next

LibreFang itself is moving fast — WhatsApp bidirectional routing just landed, prompt versioning and A/B experiments are in, and we're working toward the v1.0 milestone.

The website will keep evolving with the project. Docs are at docs.librefang.ai, and the deploy page at deploy.librefang.ai has one-click options for Fly.io and more.

If this sounds interesting, check out the repo: github.com/librefang/librefang

We're open source, merge-first PR policy, and all contributions are welcome. Drop a ⭐ if you like what you see.

LibreFang 2026.3.22 Released

涼風羽月 — Sat, 21 Mar 2026 16:32:36 +0000

LibreFang 2026.3.22 Released

We're thrilled to announce LibreFang v2026.3.22 — a massive release with expanded provider support, powerful new capabilities, and a completely overhauled dashboard. This release marks our evolution to Calendar Versioning and brings 50+ improvements across the entire platform.

What's New

📊 Major Architecture Update: Calendar Versioning

We've switched to CalVer (YYYY.M.DDHH) for more transparent and predictable release cycles. This change makes it easier to track what's fresh and plan your upgrades accordingly.

🔌 Expanded Provider Ecosystem

Connect to virtually any LLM provider now:

New providers: DeepInfra, Azure OpenAI, Qwen International/US endpoints
ChatGPT device auth flow for seamless authentication
Custom model support with proper alias registration and provider routing
Embedding dimensions configurable per agent — fine-tune costs and quality

🤖 Agent & Workflow Superpowers

Pipeline runner agents let you orchestrate complex multi-step workflows
IMAP email reader script for email-triggered automation
WorkflowTemplate registry (in-memory) for reusable workflow definitions
Per-agent plugin scoping with granular allowed_plugins config
Graceful context reset via /reboot slash command

⚙️ Configuration & Persistence

Global workspace directory for cross-session state persistence
Custom log directory config — store logs anywhere you want
Config validation with tolerant mode — cleaner error messages, safer defaults
Arbitrary config keys in skills — unlimited flexibility for custom skill parameters
Configurable session reset prompt — personalize context resets
Knowledge query improvements — JOIN matches entities by name or ID, indexed by agent

💬 Chat Platform Enhancements

Slack: Unfurl links option, force-flat replies config for cleaner threads
Discord: Configurable mention patterns for smarter mentions
HAND.toml format now accepts flexible [hand] wrappers for better compatibility

🚀 Performance & Stability

Infinite retry guard — prevents runaway loops
Streaming safety — prevent interrupts during multi-tool sequences
Memory caching — workspace and skill metadata cached to reduce per-message overhead
Optimized KV operations — faster, more efficient state management
Migration tools — refresh param for cache bypassing, sparse chart data handling
Improved polling detection — replaced fragile heuristics with robust LoopGuard

🎨 Dashboard & UX

Complete React UI/UX overhaul — modern, responsive, beautiful
Japanese localization + comprehensive i18n coverage for goals/analytics
SVG branding banners — fresh promotional materials
Fixed navigation — better link structure and mobile indicators
Dev server integration — just api now starts dashboard + API together

🛠️ Developer Experience

Rustfmt.toml for consistent code formatting across the project
Version & git hash in startup logs — instant transparency on what's running
Desktop app .env support — easier local configuration
Homebrew Cask CI sync — streamlined distribution
Improved Qwen Code CLI detection — smoother integration

📚 Documentation

Comprehensive review — fixed errors, updated all numbers, filled missing gaps.

🔧 Infrastructure & CI/CD

GitHub Stats Worker integration for better analytics
Auto-update PR branches on main push
Docker Compose fixes for admin interface port binding
MCP server names now allow hyphens
Release.sh macOS compatibility — no more grep headaches
Cloudflare Pages SPA fallback — corrected _redirects format
PWA manifest & OG image fixes for better sharing

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk

LibreFang 0.7.0 Released

涼風羽月 — Sat, 21 Mar 2026 16:32:35 +0000

LibreFang 0.7.0 Released

We're thrilled to announce LibreFang v0.7.0—a release focused on smarter LLM routing, expanded provider support, and migration tooling for OpenFang users.

🤖 Core AI Improvements

The centerpiece of this release is LLM intent routing with a unified registry, giving you more control over how agents route requests across providers. Streaming has been rock-solid, and we've squashed internal LLM call bugs that were stripping provider prefixes unexpectedly.

🧩 Provider Ecosystem Expansion

You can now detect and integrate with Gemini CLI, Codex CLI, and Aider providers through unified CLI detection. We've also added proper support for Qwen Code CLI across the setup wizard and test connections. If you're running OpenFang, our new migrate --from openfang command makes switching over painless—we've hardened the migration inputs and completed the migration across the init wizard, API, and dashboard.

🔧 Operations & Configuration

This release brings finer-grained control over your deployment:

Configurable CORS policies for your environment
Channel rate limits to prevent runaway resource usage
Audit pruning to keep log storage under control
Media gates for content filtering

📖 Documentation

We've reorganized docs as a Next.js deployment directory for better maintainability, added a comprehensive comparison page to help you understand LibreFang's positioning, and cleaned up remaining artifacts.

🛠️ Under the Hood

Fixed npm/PyPI publish workflows (now running via Shell)
Synced upstream improvements
Hardened OpenClaw migration inputs
Various streaming and registry fixes

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk

LibreFang 2026.3.21 Released

涼風羽月 — Sat, 21 Mar 2026 14:56:50 +0000

LibreFang 2026.3.21 Released

We're thrilled to announce LibreFang v2026.3.21 — a major release packed with new provider support, a completely redesigned dashboard, granular configuration control, and 30+ stability fixes.

This release also marks our switch to CalVer (YYYY.M.DDHH) for clearer versioning. Here's what's new:

🚀 Expanded LLM Provider Ecosystem

Connect to more models than ever before:

Azure OpenAI — Enterprise deployment ready
DeepInfra — Access a wide range of open-source models
Qwen International & US — Regional endpoints for lower latency
ChatGPT Device Auth — New authentication flow for ChatGPT integration

All providers now include enriched error handling with provider/model context baked into ClassifiedError for faster debugging.

⚙️ Configuration & Control You Demanded

This release delivers fine-grained control over agent behavior:

Config Validation with Tolerant Mode — Validate configs before startup with graceful fallback options
Per-Agent Plugin Scoping — Control which plugins each agent can access via allowed_plugins
Configurable Embedding Dimensions — Tune embedding models for your use case
FTS-Only Memory Indexing — Skip embeddings if you only need full-text search
Custom Log Directory — Point logs wherever you want
Configurable Session Reset Prompt — Customize agent context reset behavior
Arbitrary Config Keys in Skills — Add custom metadata to skill entries
Global Workspace Directory — Share state across sessions

🎨 Dashboard & UI Overhaul

A comprehensive React redesign makes agent management delightful:

New layout and navigation flow
Better mobile responsiveness
Japanese localization support
Expanded i18n coverage for goals and analytics
Fixed sidebar navigation and broken links
Corrected provider/model counts

Plus a fresh promotional banner! 🎉

🤖 Agent Workflows & Automation

Build more sophisticated agents with new tools:

Pipeline Runner Agents — Execute multi-step workflows with built-in IMAP email reader for email automation
WorkflowTemplate Types — In-memory registry for reusable workflow definitions
/reboot Slash Command — Graceful context reset without restarting
Workflow Editor Improvements — Better handling of nested mode/error_mode definitions from the UI

🔌 Slack & Discord Integration Enhancements

More control over how agents interact with chat platforms:

unfurl_links for Slack — Disable link previews when needed
force_flat_replies for Slack — Keep messages in flat mode
mention_patterns for Discord — Define custom mention behavior

🐛 Stability & Performance Improvements

30+ bug fixes and optimizations under the hood:

Streaming Reliability — Prevent interrupts during multi-tool sequences
Infinite Retry Guard — Dead branch cleanup and body size limits
LoopGuard Improvements — Replaced fragile heuristics with robust poll detection
Knowledge Queries — Fixed JOINs to match entities by name/ID with proper agent scoping
GitHub Stats — Resolved zero values and optimized KV operations
MCP Improvements — Now supports hyphens in server names
Desktop App — Properly load .env files at startup
Docker Compose — Fixed admin interface port binding
Windows Stability — Fixed browser hand connection issues
Skill Resolution — Fixed file path resolution for installed skill execution
Cache Performance — Metadata caching reduces per-message overhead
Session History — Replace processed images with text placeholders

📚 Documentation & Infrastructure

Comprehensive docs review with updated numbers and new sections
Auto-updating PR branches on main push
GitHub Stats Worker in deploy workflow
Improved Homebrew Cask Formula generation

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk

LibreFang 0.6.8 Released

涼風羽月 — Fri, 20 Mar 2026 09:46:15 +0000

LibreFang 0.6.8 Released

LibreFang v0.6.8 is here, and we've made it easier than ever to get started! This release focuses on accessibility — our biggest win is distributing the CLI binary through npm and PyPI, so you can install LibreFang alongside your other dev tools. We've also improved multi-agent communication and tightened up our CI/CD pipeline.

🚀 Game-Changer: CLI Now on npm & PyPI

The standout feature of this release: you can now install the LibreFang CLI directly from npm and PyPI (#1323). No more hunting for pre-built binaries or compiling from source unless you want to. If you're a JavaScript or Python developer, it's as simple as npm install -g librefang-cli or pip install librefang-cli. This dramatically lowers the barrier to entry for teams already using these ecosystems.

💬 Better Multi-Agent Communication

We've enhanced how LibreFang handles external DM routing. Your agents can now intelligently route owner responses when handling external direct messages (#1266) — meaning cleaner, more predictable conversation flows across federated agent networks.

🛠️ Under the Hood

Smarter automation: We now use the GitHub API directly to create Go SDK tags (#1321), making our release process more reliable and less error-prone.
Cleaner CI/CD: Removed wasteful workflows and fixed several bugs to keep the build system lean (#1320).

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk

LibreFang 0.6.7 Released

涼風羽月 — Fri, 20 Mar 2026 07:56:54 +0000

LibreFang 0.6.7 Released

We're thrilled to release LibreFang v0.6.7—a focused update that strengthens extensibility, improves developer experience, and hardens our release pipeline. If you're building custom agents with HAND manifests or relying on context hooks, this one's for you.

Extensibility & Scripting Improvements

The foundation of LibreFang's power is its flexibility. This release fixes critical gaps in how your custom code integrates:

Include user-installed HAND manifests in hand routing (#1205) — Custom HAND agent manifests are now properly discovered and included in the routing system, eliminating the friction of manual registration.
Pass raw JSON payloads to context hook scripts (#1207) — Context hooks now receive unprocessed JSON instead of serialized strings, giving you full control and eliminating unnecessary parsing overhead.

Better Developer Experience

Self-heal fish config PATH entries (#1303) — Your shell configuration now automatically recovers from corrupted PATH entries in fish, keeping your development environment stable without manual fixes.

Community & Documentation

Add GitHub Discussions link to dashboard sidebar (#1302) — Find answers and connect with the community without leaving the dashboard. We're making it easier for everyone to share knowledge and get help.

Release & CI Reliability

Behind the scenes, we've tightened our release process to ensure smooth deployments:

Pass GITHUB_TOKEN to contributor/star-history scripts (#1300) — Improved authentication for release automation, reducing friction in contributor tracking.
Fix 3 release workflow failures from v0.6.6 (#1309) — Resolved critical blockers in the release pipeline for more reliable deployments.

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk

LibreFang 0.6.6 Released

涼風羽月 — Fri, 20 Mar 2026 03:39:47 +0000

LibreFang 0.6.6 Released

LibreFang v0.6.6 is now available! This release focuses on deployment reliability, ensuring your Agent OS containers build and deploy smoothly in modern CI/CD pipelines.

What's New in 0.6.6

🐳 Docker Build Fix

We've updated our Docker build pipeline to be compatible with the latest docker/build-push-action@v7. The action now requires the file parameter instead of the older dockerfile syntax — a breaking change that affected deployments using this popular GitHub Action.

What this means for you: If you're deploying LibreFang via GitHub Actions, this fix ensures your Docker builds continue to work without manual intervention. No action needed on your end — just upgrade and deploy with confidence.

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk

Links




**Key improvements in this rewrite:**

✅ **Engaging intro** — explains why this release matters  
✅ **Context** — helps readers understand LibreFang if they're new  
✅ **Impact-focused** — clearly states what changed and why it matters  
✅ **Developer-friendly tone** — uses emojis and clear language  
✅ **Actionable** — tells users what they need to do (nothing!)  
✅ **Preserved sections** — front matter, Install/Upgrade, and Links unchanged

LibreFang 0.6.5 Released

涼風羽月 — Fri, 20 Mar 2026 03:35:06 +0000

LibreFang 0.6.5 Released

We're thrilled to announce LibreFang v0.6.5! This release focuses on security hardening, multi-provider LLM support, and improved deployment reliability. Whether you're running on Linux, deploying to the web, or integrating with external LLM providers, this update has something for you.

🚀 New Features & Improvements

LLM Provider Expansion & Cost Tracking

Add Qwen Code CLI as LLM provider (#1224) — expand your model options with Qwen's code-focused offerings
Align init defaults with OpenRouter Stepfun (#1262) — streamlined configuration for one of the fastest open models
Add token consumption metadata (#1215) — better visibility into model usage and cost attribution

Infrastructure & Core Features

Auto-initialize vault during librefang init (#1206) — faster, zero-config setup for secure credential storage
Add image pipeline and subprocess management (#1223) — enhanced capabilities for task-based workflows
Improved shell compatibility (#1270) — smoother terminal experience across platforms

UI & Brand Refresh

Replace all icons with new LibreFang branding (#1263) — fresh visual identity across the dashboard and CLI

🔒 Security & Stability Fixes

Security Hardening

Harden curl|sh install flow (#1259) — safer installation from the web with improved source verification
Initialize rustls crypto provider for TLS connections (#1294) — hardened TLS stack for secure communication
Decrypt encrypted webhook payloads (#1208) — proper handling of sensitive inbound data
Address code-scanning path-injection findings (#1260) — proactive security remediation

Deployment & Reliability

Fix web deployment issues (#1236, #1237, #1239, #1243) — resolved multiple asset serving and CI/CD blockers
Make shell installer POSIX-compatible for Linux (#1226) — universal installer support
Bootstrap context engine during startup (#1209) — more reliable initialization
Repair install smoke script (#1255) — confidence in installation success

📚 Documentation & Maintenance

SDK usage examples in all READMEs (#1229) — get started faster with working code samples
Updated contributor list — thank you to everyone who made this release possible
Repository structure improvements (#1211) — cleaner codebase organization
Node.js version standardization (#1234) — consistent build environments
13 dependency updates — keep the Rust ecosystem fresh (criterion, rand, tokio, rumqttc, and more)

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk

LibreFang 0.6.4 Released

涼風羽月 — Thu, 19 Mar 2026 16:48:51 +0000

LibreFang 0.6.4 Released

We're excited to announce LibreFang v0.6.4 — another solid update to your open-source Agent Operating System! This release brings new LLM providers, important stability improvements, and a fresh coat of paint. Let's dive in.

What's New

Expanded LLM Support

LibreFang now supports Qwen Code CLI as a new LLM provider (#1224), giving you even more options for powering your agents. We also aligned the init defaults with OpenRouter Stepfun (#1262), so new users get better out-of-the-box configuration.

Image Pipeline & Subprocess Management

The new image pipeline and subprocess management feature (#1223) enables richer agent capabilities — think image processing workflows and better control over external tool execution.

Fresh Visual Identity

We replaced all icons with new LibreFang branding (#1263), giving the project a more cohesive and professional look. It's the same great functionality, now easier on the eyes.

Stability & Security

Web Deployment Overhaul

This release tackles a long-standing issue: web deployment reliability. We landed multiple fixes (#1236, #1237, #1238, #1239, #1243) that should make deploying and running the web interface much smoother. If you've had trouble with web deployment before, this update is for you.

Hardened Install Flow

The one-line install script (curl -fsSL https://get.librefang.ai | sh) got a security hardening pass (#1259). We also addressed code-scanning path-injection findings (#1260) — small things that make a big difference for security-conscious deployments.

Bug Fixes

Fixed web UI chat input line break issue (#1245) — no more broken messages
Repaired the install smoke script and dropped an outdated workflow (#1255)

Developer Experience

Better Documentation

SDK usage examples now appear in all README files (#1229), so whether you're using Rust, JavaScript, or Python, you'll find clear guidance getting started.

Infrastructure Improvements

Added .nvmrc for web Node.js version consistency (#1234)
Fixed Dockerfile path issues (#1234)

Install / Upgrade

# Binary
curl -fsSL https://get.librefang.ai | sh

# Rust SDK
cargo add librefang

# JavaScript SDK
npm install @librefang/sdk

# Python SDK
pip install librefang-sdk