Fuxi

fuxicodex活跃维护

装在终端里的自主 AI 编程助手,能直接改代码、跑命令、调用工具,并按成本自动在多家大模型之间路由,省下调用开销。

FuXi is a fast, self-contained AI coding agent that lives in your terminal — edit code, run commands, and drive tools, with cost-aware routing across LLM providers.

v0.1.8发布于 2026-09-22 11:59 UTC3,193star220fork同步于 2026-11-10 23:42 UTC

怎么上手

由 README 提炼,执行前请确认
curl -fsSL https://downloads.fuxicode.com/bootstrap.sh | bash
fuxi --version
硬件要求按 README 说明

README 未说明硬件要求;仅说明为 Go 编写的单静态二进制、无运行时依赖,未提及 GPU、显存或 CPU 限制。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

终端里的 AI 编程代理,能读写代码、跑命令、调工具,并按成本在多家 LLM 间路由

装在终端里的自主 AI 编程助手,能直接改代码、跑命令、调用工具,并按成本自动在多家大模型之间路由,省下调用开销。

核心能力

  • 在终端 TUI 中直接读代码、改文件、执行命令
  • 按成本感知在多个 LLM 提供商间路由并自动故障转移
  • 作为 MCP 客户端接入外部工具
  • 用 Go 编译成单个静态二进制,无运行时依赖
  • 内置自更新,安装与升级用同一条命令

容易踩的坑

需要 FuXi 账号,先运行 fuxi login 登录(无头/CI 用 fuxi setup-token);默认使用 FuXi 托管模型,想用自有提供商需另设 API key 或改 ~/.fuxi/config.yaml;--dangerously-skip-permissions 会跳过工具调用确认,只应在容器或虚拟机中使用。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

4 个版本v0.1.8
  1. v0.1.8最新正式版2026-09-22 · 2026-09-22 11:59 UTC

    FuXi 0.1.8 Release Announcement

    Release Date: September 22, 2026

    We are pleased to announce the release of FuXi 0.1.8, a major update following 0.1.7. This release introduces rate-limit banners and an official plugin marketplace mirror, and delivers systematic stabilization and refinement across session storage, the engine, permissions, Windows compatibility, and the user interface.

    New Features

    • Rate-limit banners: unified rate-limit data now feeds subscription banners; usage beyond the limit is silently rolled into additional usage with clear notification.
    • Official plugin marketplace mirror: the plugin marketplace is now served from an official GCS mirror, making plugin installs more stable and reliable.

    Performance

    • Smoother long-session interactions: estimated scroll offsets and zero render-time filesystem syscalls reduce a cold first frame from ~1.6s (1000 lines) to ~160ms; scrolling performance is now independent of line count.
    • Faster resume & reads: a resume reads the transcript only once (34MB: 4.6s → 0.8s); sessions larger than 5MiB are read through a precompacted fast path in 1MB sequential chunks (~4.9× on a 30MB transcript); write-side 100ms batching keeps the disk format unchanged.
    • Streaming render fix: the linkify O(n²) full-render issue is resolved (20KB single line: 278ms → 2.9ms); streaming output no longer appears non-streaming.

    Sessions & Messages

    • Session storage-chain optimization: a precompact read fast path, write-side batching, and live-cache re-append are introduced (metadata such as titles and tags flush synchronously, and external SDK writes are absorbed via a 64KB tail window).
    • Message-chain integrity: parentUuid chains now fully link every participant, with automatic re-linking after forks; switching sessions no longer loses in-flight messages; a unified session UUID registry fixes the /clear cache invalidation issue.

    Permissions & Security

    • Dialog & rules: the permission dialog now uses a numbered Select list; "Always Allow" clearly displays the exact rule to be persisted; low-risk file commands (mkdir/cp/mv/touch/rmdir) are relaxed to command-name prefix rules.
    • Stability & Bash safety: the whole-UI freeze caused by permission dialogs is resolved (approval sends are now non-blocking); the Bash read-only gate is hardened (backticks and newlines can no longer bypass auto-approval); permission suggestions are built once per request and differentiated by reason.

    Windows Compatibility

    • Startup & rendering: when Git for Windows is missing, startup now provides installation guidance directly (no longer stuck behind the login flow); CJK console glyphs and borders adapt to terminal capabilities, resolving mojibake, tofu, and input-box jitter; subprocess output is decoded strictly as UTF-8.

    Engine & Tools

    • Non-streaming fallback: on empty or interrupted streams, the current turn is automatically retried via a non-streaming request.
    • Tool-execution dedup: a tool state machine and tracker form a dedup closed loop, eliminating duplicate tool cards.
    • Tool behavior unification: Read, Write, Edit, Notebook, and PDF tools now share consistent behavior and error messages; non-standard error prefixes are removed.

    UI / MCP / Misc

    • UI: the task list is deduplicated (the right sidebar is the single task surface); the plan-approval dialog fits exactly, with buttons remaining visible on long plans.
    • MCP: the command allowlist is re-seeded after configuration reloads (servers added at runtime are no longer blocked); ~/.fuxi.json global configuration is unified.

    Installation & Upgrade

    Installation scripts automatically fetch the latest version with integrity verification.

    macOS / Linux

    curl -fsSL https://downloads.fuxicode.com/bootstrap.sh | bash
    

    Windows (PowerShell)

    irm https://downloads.fuxicode.com/bo
    
  2. 0.1.6v0.1.62026-09-07 · 2026-09-07 10:22 UTC
    查看更新说明

    FuXi 0.1.6 Release Announcement

    Release Date: September 7, 2026

    FuXi 0.1.6 is now available. This release focuses on core experience consistency and stability: unified session and message handling, hardened login flow, cross-platform compatibility improvements, and a number of stability fixes.

    New Features

    • Unified session & message handling: chat messages are consolidated into a single message model, removing inconsistencies between multiple handling paths; message parent-child chains are preserved more completely, and partially-compacted history survives session resume.
    • Hardened login flow: cross-process token refresh is serialized to prevent token-chain failure; tokens are refreshed proactively before expiry to avoid forced re-login; login no longer times out — it waits until the user cancels.
    • Model selection validation: the /model command now validates that the selected model is supported by the current endpoint, giving clear feedback when an invalid model name is entered.

    Improvements & Fixes

    • Engine: empty responses automatically retry via non-streaming requests; fixed repeated injection of external file changes and conditional memory; coordinator queue drained before every request; gateway length errors correctly recognized as context-window overflows.
    • Bash / Windows: unified command-line parsing reduces misclassification; strict UTF-8 subprocess output on Windows avoids garbled text; nested-heredoc crash fixed; startup git-bash check and working-directory exclusion added.
    • UI & Rendering: markdown rendering improvements, box-drawing table format, sidebar reasoning state and session cost, and chat lag fixed on huge content; CJK character-width handling now applies only to legacy Windows consoles.
    • Tasks / Agent: standardized task IDs and output paths; notification queue priorities (immediate / later / next); stricter stop-task conditions; agent_busy claim check.
    • Files & Search: more accurate search timeouts; staged protection for very large file reads; Grep content checks and UNC path handling fixed.
    • MCP: /mcp toggle persisted per-project; improved port allocation and lock-backoff; staged truncation for tool output.
    • Permission & Sandbox: static directory rules support subtree matching; sandbox configuration now takes effect with settings; unified session grant logic.
    • Context compaction: staged decision for file restore after compaction; improved shared-cache partial compaction.
    • Image recognition: recognition configuration is endpoint-scoped and no longer affects the main model's vision judgment; recognition-model refusals are never cached.

    Installation / Upgrade

    Installation scripts fetch the latest version automatically with integrity verification.

    Windows (PowerShell)

    irm https://fuxicode.com/install.ps1 | iex
    

    Windows (CMD)

    curl -fsSL https://fuxicode.com/install.cmd -o %TEMP%\install.cmd && %TEMP%\install.cmd
    

    macOS (x64 / ARM64)

    curl -fsSL https://fuxicode.com/install.sh | bash
    

    Linux (x64 / ARM64)

    curl -fsSL https://fuxicode.com/install.sh | bash
    

    Existing users can upgrade by re-running the corresponding command. For issues, please report them at https://github.com/fuxicodex/Fuxi/issues.

  3. 0.1.2v0.1.22026-08-06 · 2026-08-06 15:18 UTC
    查看更新说明

    FuXi 0.1.2 Release Announcement

    Release Date: August 6, 2026

    FuXi 0.1.2 is now available, with major improvements across multi-window coordination, image capabilities, and the plugin ecosystem.

    New Features

    • Multi-window coordination: switch seamlessly between concurrent sessions without interrupting your current work.
    • Image captioning: non-vision models can now generate image descriptions automatically, enabled by default.
    • Vision capability is automatically detected from known provider capabilities, with no manual configuration required.
    • Thinking mode now adapts to the task type for smarter responses.
    • Tool-level thinking has been refined, and status blink for collapsed groups in the TUI is restored.
    • Voice capture and browser tools are now integrated through the native extension bridge.

    Improvements & Fixes

    • Unified MCP plugin lifecycle: plugins from manifest, channel declarations, session plugins, and other sources all load under one consistent contract.
    • Multiple security hardening improvements: plaintext MCP tokens removed, OAuth credentials scoped to their trust domains, plugin secrets kept out of prompts, and plugin reloads no longer expose stale state.
    • Path traversal is blocked before normalization, preventing path escape risks.
    • Memory extraction now runs asynchronously, with an optimized memory_saved card.
    • Model cache isolation stays stable across sessions, and compacted context remains consistent across TUI turns.
    • Each model gets a stable user identity, and long prompts are preserved intact across the OpenAPI boundary.
    • Plugin LSP lifecycle options are supported, and usable LSP plugins are recommended after real file edits.
    • Fixed empty tool results being lost before transcript replay.

    Installation / Upgrade

    Installation scripts fetch the latest version automatically with integrity verification.

    Windows (PowerShell)

    irm https://releases.fuxicode.com/bootstrap.ps1 | iex
    

    Windows (CMD)

    curl -fsSL https://releases.fuxicode.com/install.cmd -o %TEMP%\install.cmd && %TEMP%\install.cmd
    

    macOS (Intel / Apple Silicon)

    curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bash
    

    Linux (x64 / ARM64)

    curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bash
    

    Existing users can upgrade by re-running the corresponding command. For issues, please report them at https://github.com/fuxicodex/Fuxi/issues.

  4. 0.1.1v0.1.12026-08-05 · 2026-08-05 18:54 UTC
    查看更新说明

    FuXi 0.1.1 Release Announcement

    Release Date: August 6, 2026

    FuXi 0.1.1 has been released. This release includes the following changes.

    New Features

    • Remote Control: support for CCR v2 sessions with secure worker credential exchange and real-time event streaming, synchronized with the local TUI
    • Remote input integrated with the local session; slash commands and prompts processed under unified security policies
    • Image preprocessing upgraded: automatic resizing and compression before upload, using the Lanczos3 scaling kernel
    • Built-in file search tools (bfs/ugrep) with no additional dependencies, available on Windows, macOS, and Linux
    • Chrome integration dialog, enabled by default
    • @mention content delivered directly to the model
    • Bash cards expanded by default
    • Exit-word routing and automatic detection of long-running task keywords

    Improvements & Fixes

    • Optimized context compaction and tool result budgeting for more stable long-conversation streaming
    • Fixed Windows path conversion, snapshot, hooks, and permission rule issues
    • Fixed deepseek-v4 output limits and API request parameters (top_p)
    • Token refresh interval extended to 6 hours
    • Fixed attachment ordering, message boundaries, and hook completion order
    • Improved WebSocket 401 auto-recovery mechanism

    Installation / Upgrade

    Installation scripts fetch the latest version automatically with integrity verification.

    Windows (PowerShell)

    irm https://releases.fuxicode.com/bootstrap.ps1 | iex
    

    Windows (CMD)

    curl -fsSL https://releases.fuxicode.com/install.cmd -o %TEMP%\install.cmd && %TEMP%\install.cmd
    

    macOS (Intel / Apple Silicon)

    curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bash
    

    Linux (x64 / ARM64)

    curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bash
    

    Existing users can upgrade by re-running the corresponding command. For issues, please report at: https://github.com/fuxicodex/Fuxi/issues

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    FuXi

    English | 简体中文

    GitHub stars Release Last commit License

    FuXi is a fast, self-contained terminal AI coding agent. It reads code, edits files, runs commands, and drives tools from a rich TUI, with cost-aware routing across LLM providers and automatic failover. Built in Go, it ships as one static binary with no runtime dependencies.

    Terminal-first · Provider-agnostic · Bring your own key · MCP client · Self-updating

    Homepage: https://www.fuxicode.com

    FuXi's roughly 2 million lines of code were written entirely by FuXi itself.

    FuXi in action

    Install

    macOS / Linux

    curl -fsSL https://downloads.fuxicode.com/bootstrap.sh | bash
    

    Windows (PowerShell)

    irm https://downloads.fuxicode.com/bootstrap.ps1 | iex
    

    Windows (CMD)

    curl -fsSL https://downloads.fuxicode.com/install.cmd -o "%TEMP%\fuxi-install.cmd" && "%TEMP%\fuxi-install.cmd"
    

    Then verify and launch:

    fuxi --version
    fuxi doctor    # environment sanity checks
    fuxi           # start a session
    

    Install and upgrade are the same command. Full options, uninstall steps, and troubleshooting: setup docs.

    Get started

    A FuXi account is required. Run fuxi, then:

    1. Register and sign in — fuxi login (or fuxi setup-token for headless/CI). Registration processes only minimal account data.
    2. Connect a model (optional) — sign-in gives access to FuXi-managed models; to use your own provider instead, set an API key via environment variable or ~/.fuxi/config.yaml (fuxi init generates a template). Or run fuxi wizard.

    Then type a prompt and press Enter, for example:

    Fix the failing tests in this repository.
    

    Useful commands: /model switch models · /help browse all commands · /config open settings · /privacy-settings privacy controls · /exit quit.

    Full walkthrough: usage guide.

    Permissions

    Sensitive tool calls ask for approval unless you change the permission mode at launch.

    --dangerously-skip-permissions starts in bypassPermissions, so tool calls run without a prompt. Extreme commands such as rm -rf / are still blocked. Use it only in a container or VM; on Linux and macOS, root and sudo are rejected.

    --allow-dangerously-skip-permissions keeps the normal mode and adds bypassPermissions to the Shift+Tab cycle.

    --permission-mode bypassPermissions behaves like --dangerously-skip-permissions. The same flag also accepts default and plan.

    Data, privacy, and retention

    FuXi runs on your machine and keeps your work local.

    • By default, your code and conversations are never collected, stored, or retained by FuXi. With your own key they go straight to the provider you choose; with FuXi-managed models they are transmitted only to serve that request. Conversation content is sent to FuXi only if you explicitly enable send_conversations (off by default).
    • Credentials stay in local ~/.fuxi/ and are never uploaded.
    • Sessions, checkpoints, memory, and audit logs live on your device and can be deleted at any time by removing the config directory.
    • FuXi processes limited account and technical information to operate the service; the available analytics are disclosed and can be turned off. See Privacy Controls.

    Full details: Privacy Policy · Security Whitepaper · Terms of Service.

    Documentation

    GuideWhat it covers
    Usage guideFirst session, permissions, sessions & memory, tools & MCP, CLI reference, troubleshooting
    ArchitectureExecution base, persistence, routing, multi-window coordination, extensibility
    Keyboard shortcutsTerminal-UI key reference
    Environment variablesFull environment-variable reference
    FAQCommon questions
    Benchmark reportReproducible evaluation methodology and results
    Security & privacyPrivacy Policy, Security Whitepaper, Terms of Service, Usage Policy, compliance and governance
    ChangelogRelease history
    SupportWhere to get help

    Usage policy

    You must use FuXi in accordance with the laws applicable to you. FuXi is aimed at developers and professional users and is not directed at children under 14; users aged 14–17 require a parent or guardian.

    Disallowed uses and full requirements: Usage Policy. If you are unsure whether a use is lawful, take advice before proceeding.

    Contributing

    The product source is proprietary; this repository hosts the documentation, installers, and issue tracker, which are open to contributions. See CONTRIBUTING.md.

    License

    Proprietary. Copyright © 2026 FUXI. All rights reserved.