Pozwól agentowi prowadzić Twoją listę zadań

MCP czy CLI?

Wybieraj narzędzia MCP, gdy Twój agent ma już połączenie MCP z TaskForge. Są typowane, zwracają ustrukturyzowane błędy, na podstawie których agent może się samodzielnie poprawić, i niczego nie wymagają w Twoim PATH. Sięgnij zamiast tego po CLI w kontekstach powłoki bez połączenia MCP: skrypty, cron, CI albo agent kodujący pracujący na lokalnej kopii repozytorium. 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

{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

W systemie Windows postaw cmd /c przed npx. Desktopowe klienty MCP, takie jak Claude Desktop, uruchamiają serwer bez powłoki, a npx to skrypt .cmd, który Windows uruchamia tylko przez powłokę:

{
  "mcpServers": {
    "taskforge": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "C:\\path\\to\\your\\vault"
      }
    }
  }
}

Zbudowano taskforge ze źródeł zamiast używać npx? Skieruj konfigurację bezpośrednio na plik binarny:

"command": "taskforge",
"args": ["mcp", "--stdio"]

Tylko na komputery, bo tam żyją klienci MCP. taskforge jest dostępny jako jeden natywny plik binarny dla macOS i Windows, a serwer MCP jest jednym z jego podpoleceń. Wersja na Linux pojawi się wkrótce.

Pełny zestaw narzędzi

30 narzędzia w sumie, obejmujące cały cykl życia zadania: tworzenie, odczyt, aktualizację, ukończenie, archiwizację i usuwanie, każde z wariantem grupowym; przenoszenie, zmianę rodzica oraz konwersję między wierszem inline a plikiem zadania; sprawdzenie lint przed zapisaniem wiersza; wywołanie doctor do sprawdzenia stanu sejfu; a także zasoby schematu i przestrzeni, dzięki którym agent pozna Twój format, zanim zacznie działać. Sześć poniżej to te, po które sięgniesz najczęściej. Każde wywołanie odczytuje sejf na nowo z dysku, więc agent zawsze działa na aktualnych plikach.

Każde narzędzie ma adnotacje, dzięki czemu klient od razu widzi, które wywołania tylko odczytują, które zapisują, a które usuwają. Reszta zestawu obejmuje też bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_spaces i create_note, read_note, update_note, patch_note_block, patch_note_frontmatter, delete_note, move_note, normalize_references, get_dialect.

Trzy zasoby

Oprócz narzędzi serwer udostępnia kontekst tylko do odczytu, dzięki czemu agent poznaje zasady Twojego sejfu, zanim zacznie działać:

Jeśli nie może znaleźć Twojego sejfu

Serwer zawsze się uruchamia, nawet zanim wie, gdzie jest Twój sejf, więc Claude Desktop nigdy nie pokazuje niejasnego komunikatu "server failed to start". Gdy wywołanie narzędzia nie może rozwiązać sejfu, zwraca prosty błąd, który agent może przekazać dalej: ustaw zmienną środowiskową TASKFORGE_VAULT na ścieżkę do swojego sejfu albo zainstaluj pakiet ponownie i podaj folder sejfu, gdy zostaniesz o to poproszony.

Tylko lokalnie

Serwer MCP TaskForge działa lokalnie i odczytuje oraz zapisuje pliki Markdown Twojego sejfu. Instalacja przez npx pobiera pakiet z npm. Twój klient AI może wysyłać dane wejściowe i wyniki narzędzi do swojego dostawcy; obowiązują jego ustawienia prywatności. Twoja dotychczasowa synchronizacja sejfu przenosi zmiany między urządzeniami.

Wolisz terminal?

Jeśli wolisz obsługiwać zadania skryptami albo uruchamiać jednorazowe polecenia zamiast prowadzić je przez agenta, taskforge CLI obejmuje ten sam sejf, z tymi samymi zasadami.

Najczęściej zadawane pytania