Skip to content
Bestie

Command reference

This page lists commonly used Bestie CLI commands.

Setup

Section titled “Setup”
Terminal window
bestie --help
bestie onboard
bestie onboard --skip-provider-test
bestie status
bestie logs

Chat

Section titled “Chat”
Terminal window
bestie chat

Inside terminal chat:

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

Doctor

Section titled “Doctor”
Terminal window
bestie doctor
bestie doctor --json
bestie doctor --fix
bestie doctor --telegram-connect
bestie doctor --telegram-speech-test

Telegram

Section titled “Telegram”
Terminal window
bestie telegram setup
bestie telegram
bestie telegram --once
bestie telegram --once --transcript .bestie/logs/telegram-smoke.jsonl

Telegram voice helpers:

Terminal window
bestie telegram voice setup-local
bestie telegram voice models
bestie telegram voice download-model small
bestie telegram voice download-model small --confirm --use

Memory

Section titled “Memory”
Terminal window
bestie memory status
bestie memory pause
bestie memory resume
bestie memory list
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 forget 1
bestie memory messages --limit 5 --role user
bestie memory messages search project --limit 5 --role assistant
bestie memory export
bestie memory clear --yes
bestie memory pending --limit 5
bestie memory pending search hanoi --limit 5
bestie memory pending inspect 1
bestie memory approve 1
bestie memory reject 1
bestie memory reject-all --yes

Tools

Section titled “Tools”
Terminal window
bestie tools logs --lines 20
bestie tools memories --limit 5
bestie tools git status
bestie tools git diff
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

MCP

Section titled “MCP”
Terminal window
bestie mcp list
bestie mcp show dry-run
bestie mcp test dry-run
bestie mcp test dry-run --connect
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"}'
bestie mcp call dry-run read_file --read --ask --json '{"path":"README.md"}'

Project validation

Section titled “Project validation”
Terminal window
npm run build
npm run smoke
npm run smoke:chat
npm run smoke:doctor
npm run smoke:doctor:json
npm run smoke:doctor:fix
npm run smoke:doctor:exit-code
npm run smoke:mcp
npm run smoke:onboard
npm run smoke:status
npm run smoke:tools
npm run smoke:telegram
npm run smoke:telegram:setup
npm run eval:character
npm run eval:character:cases
npm test

Real Telegram smoke is opt-in only and requires a fresh owner message:

Terminal window
BESTIE_TELEGRAM_REAL_SMOKE=1 npm run smoke:telegram:real