Twój sejf, z terminala

taskforge to małe narzędzie wiersza poleceń, które odczytuje i zapisuje zadania w Twoim sejfie Obsidian. Korzysta z tego samego parsera co aplikacja, więc zadania cykliczne przechodzą do kolejnego wystąpienia, archiwa trafiają we właściwe miejsce, a linijki zadań zachowują Twój format. Podaj je skryptowi powłoki albo agentowi, a edytuje prawdziwe pliki markdown, nic nie jest hostowane.

Już wkrótce w TaskForge 3.0

CLI TaskForge i serwer MCP pojawią się wraz z wydaniem TaskForge 3.0. Ta strona opisuje, jak będą działać po premierze. Sama aplikacja TaskForge jest dostępna do pobrania już teraz.

CLI czy serwer MCP?

Używaj CLI w kontekstach powłoki bez połączenia MCP: skrypty, cron, CI albo agent kodujący pracujący na lokalnej kopii repozytorium. Jeśli Twój agent ma już połączenie MCP z TaskForge, wybieraj narzędzia MCP; są typowane, zwracają ustrukturyzowane błędy, na podstawie których agent może się samodzielnie poprawić, i niczego nie wymagają w Twoim PATH. Oba sterują tym samym silnikiem z identyczną semantyką, więc wybierz to, co jest już podpięte w Twoim środowisku. Ręczna edycja plików sejfu to ostateczność.

Instalacja

macOS i Linux, przez Homebrew:

Dostępne od premiery

brew install azhard/tap/taskforge

Wolisz npm? Ten sam plik binarny jest też dostępny jako pakiet:

Dostępne od premiery

npm install -g taskforge

Wersja dołączona do aplikacji, która instaluje się sama po otwarciu sejfu, jest w drodze. Do tego czasu powyższy tap Homebrew to jedyna droga.

Szybki start

Wskaż taskforge na sejf za pomocą --vault albo raz ustaw TASKFORGE_VAULT. Każda komenda odczytu przyjmuje --json, co daje wynik czytelny dla maszyn, który potrafi sparsować agent.

taskforge schema

Wypisz dialekt zadań tego sejfu: symbole statusów, format daty, pola niestandardowe, miejsce trafiania nowych zadań. To pierwsza rzecz, którą czyta agent.

taskforge add "call the plumber" --due 2026-07-10 --priority high

Dopisz zadanie do domyślnego miejsca nowych zadań w sejfie, sformatowane tak, jak Twój sejf zapisuje zadania.

taskforge query 'prop:priority_label=urgent' --sort priority --count

Policz zadania z niestandardowym polem priority_label:: urgent, od najpilniejszych. Pomiń --count, aby je wypisać.

taskforge query 'desc:"invoice" text:acme' --json

Znajdź zadania, których opis wspomina o fakturze, a tytuł zawiera acme, w formacie JSON. Akcenty i wielkość liter są ignorowane, więc cafe pasuje do café.

taskforge done <task-id>

Zakończ zadanie. Jeśli jest cykliczne, kolejne wystąpienie zostaje zapisane z powrotem do pliku, dokładnie tak, jak zrobiłaby to aplikacja.

taskforge show <task-id> --json

Odczytaj jedno zadanie wraz z hashem jego treści, dzięki czemu kolejna edycja może przekazać --if-hash i odmówić nadpisania nieaktualnej kopii.

Składnia zapytań

Argument zapytania to zestaw tokenów oddzielonych spacjami, z których wszystkie muszą pasować. Najczęstsze z nich:

text:word	Tytuł zawiera to słowo (bez rozróżniania akcentów i wielkości liter).	text:groceries
desc:"phrase"	Opis zadania zawiera tę frazę.	desc:"send invoice"
tag:name	Zadanie ma tag #name.	tag:work
prop:key=value	Niestandardowe pole key jest równe value.	prop:area=home
prop:key	Niestandardowe pole key istnieje, niezależnie od wartości.	prop:estimate
--sort due\|priority\|created	Sortuje wyniki. Domyślnie po terminie, od najbliższego.	--sort priority
--count	Zwraca liczbę dopasowań zamiast samych zadań.	--count

Klucze pól niestandardowych mogą zawierać litery, cyfry i podkreślenia, więc zarówno priority_label, jak i area_2 działają poprawnie.

Jeden wymóg: kontrakt sejfu

taskforge odczytuje niewielki plik kontraktu, taskforge/schema.json, który TaskForge zapisuje w Twoim sejfie. Opisuje on dokładny format Twoich zadań, dzięki czemu CLI edytuje zadania po Twojemu, zamiast zgadywać. Otwórz sejf w TaskForge 3.0 lub nowszym przynajmniej raz, przejdź do Settings, AI & Agents, i pozostaw włączoną opcję "Generate agent files". To zapisuje kontrakt.

Jeśli taskforge nie może znaleźć sejfu, pokazuje trzy sposoby, aby go wskazać:

Podaj --vault /path/to/vault w poleceniu.
Ustaw zmienną środowiskową TASKFORGE_VAULT.
Otwórz sejf raz w TaskForge 3.0+, aby powstał plik taskforge/schema.json, a następnie uruchom polecenie z wnętrza folderu sejfu.

Tylko lokalnie

taskforge działa na Twoim komputerze i dotyka wyłącznie plików markdown w sejfie, który mu wskażesz. Bez konta, bez klucza API, bez połączeń sieciowych. Cokolwiek już synchronizuje Twój sejf, iCloud, Dropbox czy Obsidian Sync, przenosi te zmiany na pozostałe urządzenia.

Chcesz, żeby prowadził go agent?

CLI jest dla terminali i skryptów. Jeśli chcesz, żeby Claude Desktop albo inny klient MCP dodawał i kończył zadania przez interfejs narzędzi, skonfiguruj zamiast tego serwer MCP. Ten sam sejf, te same zasady. Tak czy inaczej to ten sam plik binarny taskforge, więc wystarczy taskforge mcp --stdio, aby przełączyć go w serwer MCP.

Skonfiguruj serwer MCP →

CLI edytuje zadania. Aplikacja utrzymuje je przy życiu.

taskforge zapisuje do Twojego sejfu z dowolnego terminala; TaskForge zamienia te same pliki w listy, widżety i przypomnienia na Twoim telefonie i komputerze. Darmowy do pobrania na iPhone'a, iPada, Maca i Androida.

Pobierz za darmo - iOS i Mac

Pobierz za darmo - Android