talkbar-cli

talkbar-cli — программа командной строки, которая поставляется вместе с TalkBar. Она выполняет те же операции, что и ИИ-ассистент через MCP, — из терминала, скрипта или ИИ-агента, который умеет запускать команды. Кроме того, она запускает MCP-сервер и выполняет экспорт в фоне.

Перед началом

• talkbar-cli поставляется вместе с TalkBar. Где именно — показано в поле Настройки → Доступ по MCP → Путь к исполняемому файлу. Кнопка Добавить в PATH там же позволяет запускать программу по имени из любого терминала. См. Где установлен talkbar-cli.
• Программа открывает папку данных TalkBar или папку из TALKBAR_DATA_ROOT, если эта переменная задана. Фактический путь указан в Настройки → Доступ по MCP → Папка данных. Приложение может быть как открыто, так и закрыто.
• Программа выполняет то, что вы ввели, от вашего имени. Переключатели раздела «Доступ по MCP» на неё не действуют, а правила администратора и лимиты тарифа — действуют. См. Что игнорирует командная строка.

talkbar-cli --version
talkbar-cli --help
talkbar-cli tools --help

В примерах используются оболочка POSIX в macOS или PowerShell в Windows. Если оболочка иначе обрабатывает кавычки в JSON, используйте --args-file.

Команды

talkbar-cli call … (без tools) — ошибка использования, в ответ на которую предлагается talkbar-cli tools call.

Глобальные параметры

Эти параметры можно указывать до или после команды:

Список и описание операций

talkbar-cli tools list
talkbar-cli tools list --compact
talkbar-cli tools info notes.create
talkbar-cli --output json tools info notes.create

• tools list выводит таблицу с идентификатором, видом (read или mutation), категорией и описанием, а затем общее количество. С --output json для каждой операции выводятся заголовок, описание, категория, вид, переключатель MCP по умолчанию и полная схема входных данных.
• tools list --compact выводит по одной строке на операцию: идентификатор, вид (read или change) и краткое описание, разделённые табуляцией. Это самый экономный указатель для скриптов и ИИ-агентов.
• tools info <id> выводит описание операции, включена ли она по умолчанию в MCP, строку использования и принимаемые аргументы в виде JSON Schema. Аргументы — JSON в camelCase.

В список входят все операции, которые не заблокировал администратор. Аргументы и результаты каждой операции описаны в справочнике операций.

Запуск одной операции

Передайте аргументы в виде объекта JSON:

talkbar-cli tools call sessions.list --args '{"limit":5}'
talkbar-cli tools call notes.get --args '{"noteId":"note-k2v9w8x7c6b5n4m3l2j1h0g9"}'

workspaceId, как и в MCP, необязателен: без него используется пространство, открытое в приложении.

Аргументы из стандартного ввода или файла

Длинный текст, например текст заметки, удобнее передавать через стандартный ввод или файл, чем в командной строке:

Get-Content note.json -Raw | talkbar-cli tools call notes.create --args -

cat note.json | talkbar-cli tools call notes.create --args -

talkbar-cli tools call notes.create --args-file note.json

{
  "title": "Weekly sync follow-ups",
  "markdown": "## Follow-ups\n\n- Send the revised quote to Dana\n- Book the next sync"
}

Файлы и переданный по конвейеру текст, сохранённые с меткой порядка байтов UTF-8 (так их записывает Windows PowerShell 5), читаются правильно.

Запуск пакета

tools batch выполняет много операций в одном процессе, по порядку. Это быстрее, чем отдельная команда на каждую операцию, а открытое приложение обновляется один раз для всех.

'[{"tool":"notes.list","args":{"limit":3}},{"tool":"sessions.list","args":{"limit":5}}]' | talkbar-cli tools batch
talkbar-cli tools batch --file calls.json --stop-on-error

• На вход подаётся массив JSON из {"tool", "args"} или форма MCP {"calls": [...], "stopOnError": true}. Данные берутся из --file или из стандартного ввода, если --file не указан или равен -.
• Ограничения в 20 операций, как в MCP, нет. На [] выводится [].
• --stop-on-error (или "stopOnError": true) останавливает выполнение на первой неудачной операции.
• Результат всегда выводится одним массивом JSON, по одной записи на каждую выполненную операцию:

[
  { "tool": "notes.list", "ok": true, "result": { "items": [], "nextCursor": null, "hasMore": false, "totalCount": 0 } },
  { "tool": "sessions.get", "ok": false, "error": { "code": "not_found", "message": "Session not found in workspace" } }
]

Если хотя бы одна операция завершилась неудачей, команда, выведя все результаты, завершается с кодом 1. В стандартный поток ошибок при этом выводится, сколько операций не удалось, например 1 of 2 operations failed.

Поиск

search — это универсальный поиск приложения в терминале, включая фрагменты транскриптов:

talkbar-cli search pricing review
talkbar-cli search "renewal date" --kinds session,note --limit 10
talkbar-cli search budget --match any --output json

В табличном выводе совпадения сгруппированы по видам, у каждого — название, фрагмент и ссылка в приложении. --output json выводит тот же объект, что и talkbar_find.

Запуск MCP-сервера

talkbar-cli serve --transport stdio

Запускает MCP-сервер на стандартном вводе и выводе. stdio — единственный транспорт и он же используется по умолчанию. ИИ-приложение само выполняет эту команду с заданной TALKBAR_DATA_ROOT; см. Настройка MCP. В отличие от остальных команд, serve подчиняется всем переключателям в разделе Настройки → Доступ по MCP. --output на неё не влияет.

Экспорт

Команда exports доставляет экспорт из очереди — то же, что делает приложение, пока оно запущено. Сначала настройте места экспорта в приложении; см. Экспорт.

talkbar-cli exports run --workspace WORKSPACE_ID --batch BATCH_ID --wait
talkbar-cli exports worker
talkbar-cli exports worker --drain

Командам exports нужен --workspace (его можно узнать с помощью tools call workspace.list). exports notion connect не читает токен с клавиатуры, чтобы он никогда не появлялся на экране; передайте его по конвейеру из менеджера паролей:

Get-Secret -Name TalkBarNotionToken -AsPlainText | talkbar-cli exports notion connect --workspace WORKSPACE_ID --destination DESTINATION_ID

Чтобы сначала поставить экспорт в очередь, используйте tools call exports.enqueue. См. Экспортировать сессию.

Вывод и ошибки

• В стандартный вывод попадают только результаты. Результаты выводятся в JSON: с отступами в терминале и компактно, если вывод передаётся другой программе или ИИ-агенту.
• Ошибки выводятся в стандартный поток ошибок строкой, начинающейся с Error:. При неверном аргументе дополнительно предлагается tools info <id>, при неизвестной операции — tools list.
• С --output json неудачная команда также выводит ошибку на стандартный вывод — в том же формате, что использует MCP:

{"error":{"code":"not_found","message":"Note not found in workspace"}}

tools call выводит собственный код операции (not_found, invalid_arguments, plan_limit и так далее); при других ошибках, например при неверном пути в --db или правиле администратора, выводится "code": "failed". tools batch выводит только массив результатов. Читайте стандартный вывод отдельно и не объединяйте с ним стандартный поток ошибок (2>&1).

Коды завершения

Для ИИ-агентов с доступом к командной строке

Агент, который умеет запускать команды, например Claude Code или Codex, может использовать talkbar-cli вместо MCP. Это не требует определений инструментов, а одна команда может выполнить много операций.

• Получайте указатель с помощью talkbar-cli tools list --compact, а аргументы одной операции — с помощью talkbar-cli tools info <id>.
• Используйте пакеты вместо циклов: один tools batch заменяет много запусков tools call, а каждый запуск talkbar-cli требует времени на старт.
• Передавайте длинный текст через --args - или --args-file.
• Ориентируйтесь на коды ошибок из --output json, а не на текст сообщений.
• Помните, что командная строка игнорирует переключатели раздела «Доступ по MCP». Давайте агенту этот способ, только если вы готовы к тому, что он сможет выполнить любую операцию, которую могли бы выполнить вы сами.

Приложение обновляется само

После успешного изменения talkbar-cli (и MCP-сервер) сообщает запущенному приложению TalkBar, что изменилось, по закрытому локальному каналу. Приложение обновляет экраны и меню в трее, где показаны эти элементы. Если приложение закрыто, ничего не отправляется и ничего не замедляется.

См. также

• Обзор MCP
• Доступ и разрешения
• Ошибки и ограничения
• Примеры
• Справочник операций