Twój sejf, z terminala
taskforge to aplikacja do zadań w wierszu poleceń, stworzona dla zadań i notatek w twoim sejfie Obsidian. Przeszukuj i kończ zadania, twórz i edytuj notatki albo przekaż te same polecenia skryptowi powłoki lub agentowi. Korzysta z parsera aplikacji i zapisuje prawdziwe pliki Markdown na twoim komputerze.
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
Wypróbuj z Node.js (zawiera npm i npx):
Zainstaluj polecenie taskforge globalnie:
Wymaga Node.js z npm/npx. npm instaluje natywny plik binarny dla macOS, Windows (x64) i Linuksa (x64 i arm64). Aplikacji TaskForge na Linuksa jeszcze nie ma; tam korzystasz z CLI i serwera MCP. CLI instaluje się oddzielnie od aplikacji; Homebrew nie jest już obsługiwany.
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.
Wypisz dialekt zadań tego sejfu: symbole statusów, format daty, pola niestandardowe, miejsce trafiania nowych zadań. To pierwsza rzecz, którą czyta agent.
Dopisz zadanie do domyślnego miejsca nowych zadań w sejfie, sformatowane tak, jak Twój sejf zapisuje zadania.
Policz zadania z niestandardowym polem priority_label:: urgent, od najpilniejszych. Pomiń --count, aby je wypisać.
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é.
Zakończ zadanie. Jeśli jest cykliczne, kolejne wystąpienie zostaje zapisane z powrotem do pliku, dokładnie tak, jak zrobiłaby to aplikacja.
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/Settings/dialect.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. TaskForge/Settings to domyślna lokalizacja; folder bazowy można zmienić w aplikacji.
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/Settings/dialect.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, Androida i Windowsa.
