FAQ EN

中文 | English

Installation and Launch

macOS says the app is "damaged and can't be opened"?

No Apple developer certificate is purchased ($99/year), and ad-hoc signed apps downloaded from the internet are blocked by default. Fix:

xattr -cr /Applications/BIT.app

Or go to System Settings → Privacy & Security → click "Open Anyway". Why it works: this deletes the quarantine flag; the signature itself is intact.

Windows SmartScreen blocks the installer?

This happens because the app is not code-signed. Click "More info" → "Run anyway".

Will antivirus software flag it as a false positive?

The risk is low (native Rust build, no packing, complete metadata), but being unsigned + low prevalence can indeed trigger heuristic false positives in a few engines. The portable single-file exe is more likely to be flagged than the MSI/NSIS installers. If you hit a false positive, submit a whitelist request to the vendor in question. A properly signed release is planned.

Linux AppImage won't run?

chmod +x BIT_0.5.6_amd64.AppImage && ./BIT_0.5.6_amd64.AppImage

Does ChromeOS work?

Yes — install the deb via Crostini (Linux development environment), see Installation Guide.

AI and Chat

Which models are supported?

Any reachable OpenAI Compatible / Gemini / Claude protocol endpoint: DeepSeek, Kimi, Qwen, Doubao, Ollama, LM Studio, one-api/new-api relays, etc. One provider is active at a time.

"Fetch from API" fails to list models?

Some relay/local endpoints don't implement GET /v1/models. Just type the model name manually; chatting is unaffected.

Reply cut off mid-way / only half the output?

This is an upstream max_tokens or balance limit. BIT normalizes finish_reason and explicitly marks the truncation; if it is an upstream configuration issue, raise the limit in the provider's console.

What happens when an AI tool call fails?

The error details are sent back to the model so it can self-correct (e.g. missing parameters, hallucinated tool names); the session is not interrupted.

What is cache hit rate?

The history window is trimmed in 8-message-aligned steps, keeping the prefixes of consecutive requests byte-identical so the provider's prompt cache is hit (lowering cost and latency). ≥80% is shown in green.

Features

Is remote access on by default?

Off by default; no port is listened on. You need to enable it explicitly on the "Remote" page. See Remote Access and API.

How is auto update triggered?

After launch BIT checks automatically and downloads silently; an update pill appears in the title bar — click it to install. Quitting via the tray also applies the update automatically. See Auto Update.

Can the AI write its own tools?

Yes, and it can overwrite tools it created itself under the same name; system tools and remote tools cannot be overwritten. See Tool System.

Can it connect to MCP servers?

MCP servers using the Streamable HTTP protocol are supported; see MCP Integration for configuration.

Is there a command-line mode?

bit tui, supporting all core capabilities — sessions, tools, memory, and more — running in parallel with the desktop app. See TUI Terminal Mode.

Data

Where is data stored?

Everything is persisted under the data directory (sessions, tools, memory, audit logs, and configuration are all local JSON). Per-platform paths are listed in MCP Integration.

How do I migrate to another machine?

Copy the whole data directory (ai_config.json contains the API Key — keep it confidential).

Other

Is there a community group?

QQ group.

winget install says "not found"?

The winget install yxpil.bit submission is still under Microsoft review; use Scoop or download the installer directly for now.