Ваше хранилище, из терминала
Приложение для задач в командной строке taskforge работает с задачами и заметками в вашем хранилище Obsidian. Ищите и завершайте задачи, создавайте и редактируйте заметки или передайте те же команды скрипту командной оболочки или агенту. Оно использует парсер приложения TaskForge и записывает настоящие файлы Markdown на вашем устройстве.
CLI или MCP-сервер?
Используйте CLI в оболочках без MCP-соединения: скрипты, cron, CI или кодирующий агент, работающий в локальной копии репозитория. Если у вашего агента уже есть MCP-соединение с TaskForge, отдавайте предпочтение инструментам MCP; они типизированы, возвращают структурированные ошибки, по которым агент может сам себя исправить, и ничего не требуют в вашем PATH. Оба варианта используют один и тот же движок с одинаковой семантикой, так что выбирайте то, что уже настроено в вашей среде. Ручное редактирование файлов хранилища остаётся последним средством.
Установка
Попробуйте с Node.js (включает npm и npx):
Установите команду taskforge глобально:
Требуется Node.js с npm/npx. npm устанавливает нативный бинарный файл для macOS, Windows (x64) и Linux (x64 и arm64). Приложения TaskForge для Linux пока нет; там вы пользуетесь CLI и MCP-сервером. CLI устанавливается отдельно от приложения; Homebrew больше не поддерживается.
Быстрый старт
Укажите taskforge на хранилище через --vault, или один раз задайте TASKFORGE_VAULT. Любая команда чтения принимает --json для машиночитаемого вывода, который может разобрать агент.
Выводит диалект задач хранилища: символы статусов, формат дат, пользовательские поля, куда попадают новые задачи. Это первое, что читает агент.
Добавляет задачу в целевое место хранилища по умолчанию для новых задач, в формате, которым ваше хранилище записывает задачи.
Считает задачи с пользовательским полем priority_label:: urgent, сначала самые срочные. Уберите --count, чтобы получить список.
Находит задачи, в описании которых упоминается invoice, а в заголовке acme, в формате JSON. Регистр и диакритика игнорируются, поэтому cafe совпадает с café.
Завершает задачу. Если она повторяется, следующее вхождение записывается обратно в файл, точно так же, как это сделало бы приложение.
Читает одну задачу вместе с хешем содержимого, чтобы последующая правка могла передать --if-hash и отказаться перезаписывать устаревшую копию.
Грамматика запросов
Аргумент запроса состоит из токенов через пробел, и совпасть должны все. Наиболее употребимые:
| text:word | Заголовок содержит слово (без учёта регистра и диакритики). | text:groceries |
| desc:"phrase" | Описание задачи содержит фразу. | desc:"send invoice" |
| tag:name | У задачи есть тег #name. | tag:work |
| prop:key=value | Пользовательское поле key равно value. | prop:area=home |
| prop:key | Пользовательское поле key существует, любое значение. | prop:estimate |
| --sort due|priority|created | Упорядочивает результаты. По умолчанию по сроку, сначала ближайшие. | --sort priority |
| --count | Возвращает число совпадений вместо самих задач. | --count |
Имена пользовательских полей могут включать буквы, цифры и подчёркивания, поэтому подходят и priority_label, и area_2.
Одно требование: контракт хранилища
taskforge читает небольшой файл контракта, TaskForge/Settings/dialect.json, который TaskForge записывает в ваше хранилище. Он описывает точный формат ваших задач, поэтому CLI редактирует задачи вашим способом, а не угадывает. Откройте хранилище в TaskForge 3.0 или новее хотя бы один раз, перейдите в Настройки > ИИ и агенты и оставьте включённым «Создать файлы для агентов». Это запишет контракт.
Если taskforge не может найти хранилище, он сообщает три способа на него указать:
- Передайте --vault /path/to/vault в команде.
- Задайте переменную окружения TASKFORGE_VAULT.
- Откройте хранилище один раз в TaskForge 3.0+, чтобы появился TaskForge/Settings/dialect.json, а затем запускайте команду из папки хранилища.
Только локально
taskforge работает на вашем устройстве и трогает только markdown-файлы в хранилище, на которое вы его указали. Без аккаунта, без API-ключа, без сетевых запросов. Что бы ни синхронизировало ваше хранилище сейчас, iCloud, Dropbox или Obsidian Sync, оно же перенесёт правки на другие устройства.
Хотите, чтобы им управлял агент?
CLI предназначен для терминалов и скриптов. Если вы хотите, чтобы Claude Desktop или другой MCP-клиент добавлял и завершал задачи через интерфейс инструментов, вместо этого настройте MCP-сервер. То же хранилище, те же правила. В обоих случаях это один и тот же бинарник taskforge, так что достаточно taskforge mcp --stdio, чтобы превратить его в MCP-сервер.
Настроить MCP-сервер →CLI редактирует задачи. Приложение поддерживает их жизнь.
taskforge пишет в ваше хранилище из любого терминала; TaskForge превращает те же файлы в списки, виджеты и напоминания на вашем телефоне и компьютере. Бесплатно скачивается на iPhone, iPad, Mac, Android и Windows.
