Lệnh CLI

Lần chạy đầu

Cài, onboard, kiểm tra Doctor, rồi chat thử.

bestie onboard

Channels

Quản lý Telegram và Zalo dưới namespace hiện tại.

bestie channels list

Chạy nền

Dùng daemon cho process thủ công hoặc service cho OS-managed startup.

bestie service status

Setup

bestie --help
bestie onboard
bestie onboard --skip-provider-test
bestie status
bestie logs
bestie channels list

LLM providers

bestie llm providers
bestie llm setup --provider openai --set-default
bestie llm setup --provider anthropic
bestie llm setup --provider gemini
bestie llm setup --provider ollama
bestie llm models --provider openai
bestie llm models add --model openai/gpt-4.1 --profile openai:api-key
bestie llm models remove --model openai/gpt-4.1
bestie llm test --model openai/gpt-4.1
bestie llm profiles list
bestie llm profiles show --profile openai:api-key
bestie llm profiles remove --profile openai:api-key
bestie llm fallbacks list
bestie llm fallbacks add --model anthropic/claude-sonnet-4-5
bestie llm fallbacks remove --model anthropic/claude-sonnet-4-5

bestie llm setup ghi LLM profile và model catalog. Model primary hiện tại chỉ đổi khi dùng --set-default. Antigravity có trong lựa chọn provider, nhưng OAuth setup chưa được implement.

Chat

bestie chat

Trong terminal chat:

/help
/status
/memory
/memory pause
/memory resume
/pending

Agent Workforce

bestie agents list
bestie agents hire --id docs --name "Docs Editor" --role documentation --description "Maintain local product docs."
bestie agents assign --agent docs --brief "Review the onboarding guide."
bestie agents tasks --agent docs --status queued
bestie agents run --agent docs --limit 1
bestie agents pause docs
bestie agents resume docs

Xem Agent Workforce để biết workflow hàng đợi task local và các giá trị task status.

Local web console

bestie ui
bestie ui --no-open
bestie ui --port 8717
bestie ui --port 0 --no-open

Lệnh in URL local; hãy tự mở URL đó trong trình duyệt và giữ lệnh chạy cho đến khi dùng xong. Tự mở trình duyệt chưa được implement, nên hiện tại --no-open chỉ in thông báo giữ server chạy ngắn hơn. Local console dùng cùng runtime files ~/.bestie/ và có runtime status, Doctor, providers, character, memory, channels, approvals, MCP, tools và settings.

Doctor

bestie doctor
bestie doctor --json
bestie doctor --fix
bestie doctor --telegram-connect
bestie doctor --zalo-connect
bestie doctor --telegram-speech-test

Skills

Skills là các prompt pack tái sử dụng, được load từ .bestie/skills/<skill-name>/SKILL.md và inject vào system prompt khi chat.

bestie skills
bestie skills list

Update

Kiểm tra npm có bản Bestie mới hơn không:

bestie update
bestie update --apply

bestie update chỉ báo phiên bản mới nhất trên npm. bestie update --apply chạy npm install -g bestie-agent@latest.

Channels

Các channel adapter hiện nằm dưới bestie channels:

bestie channels list
bestie channels status
bestie channels doctor
bestie channels doctor --channel telegram --connect
bestie channels doctor --channel zalo --connect --json

Các lệnh top-level cũ như bestie telegram và bestie zalo đã được thay bằng bestie channels telegram và bestie channels zalo.

bestie channels telegram setup
bestie channels telegram
bestie channels telegram --once
bestie channels telegram --once --transcript .bestie/logs/telegram-smoke.jsonl

Shared voice helpers:

bestie voice setup-local
bestie voice setup-elevenlabs
bestie voice models
bestie voice download-model small
bestie voice download-model small --confirm --use

bestie channels telegram voice ... vẫn là compatibility alias, nhưng docs mới nên dùng lệnh top-level bestie voice ... vì voice là capability dùng chung.

Zalo

bestie channels zalo setup
bestie channels zalo
bestie channels zalo --once
bestie channels zalo --once --transcript .bestie/logs/zalo-smoke.jsonl
bestie channels zalo --transcript .bestie/logs/zalo-smoke.jsonl --capture-shape

Daemon

bestie daemon start --channel telegram
bestie daemon start --channel zalo
bestie daemon start --channel cron
bestie daemon start --channel all
bestie daemon status --channel all
bestie daemon restart --channel telegram
bestie daemon stop --channel all

Service

bestie service install
bestie service status
bestie service restart
bestie service uninstall

Lệnh service quản lý user-level startup integration: Linux systemd, macOS launchd hoặc Windows Startup shortcut. Trên Linux, Bestie dùng một bestie.service cho các service target đã cấu hình.

Memory

bestie memory status
bestie memory pause
bestie memory resume
bestie memory list
bestie memory list --scope core
bestie memory tiers
bestie memory summary
bestie memory search concise
bestie memory add communication_preference "User prefers concise replies."
bestie memory inspect 1
bestie memory edit 1 "Updated memory text."
bestie memory pin 1
bestie memory unpin 1
bestie memory move 1 --scope project
bestie memory supersede 1 2
bestie memory forget 1
bestie memory export
bestie memory clear --yes
bestie memory pending --limit 5
bestie memory pending inspect 1
bestie memory approve 1
bestie memory reject 1
bestie memory reject-all --yes
bestie memory analyze --mode duplicates
bestie memory cleanup --dry-run
bestie memory cleanup --apply --yes
bestie memory hygiene status
bestie memory hygiene doctor --fix
bestie memory hygiene trend
bestie memory rebalance --dry-run
bestie memory rebalance --apply --yes
bestie memory maintenance install --channel telegram:123456789
bestie memory maintenance status
bestie memory governance policy governed

Tools

bestie tools logs --lines 20
bestie tools memories --limit 5
bestie tools git status
bestie tools git diff
bestie tools git diff --staged
bestie tools git log --limit 5
bestie tools attachments cleanup --older-than 7d --kinds voice,audio
bestie tools attachments cleanup --older-than 7d --kinds voice,audio --confirm

Attachment cleanup mặc định là dry run. Thêm --confirm mới xóa file khớp điều kiện.

MCP

bestie mcp list
bestie mcp add remote-docs --url https://example.com/mcp --transport streamable-http
bestie mcp login remote-docs
bestie mcp login remote-docs --code <code>
bestie mcp show dry-run
bestie mcp test dry-run
bestie mcp tools dry-run --connect
bestie mcp classify dry-run read_file --category read
bestie mcp call dry-run read_file --read --json '{"path":"README.md"}'

Validation trong Bestie core repo

Các lệnh smoke/test này thuộc Bestie source repository, không phải repo docs site:

npm run build
npm run smoke
npm run smoke:channels:doctor:json
npm run smoke:zalo
npm run smoke:zalo:setup
npm run eval:character
npm test