터미널로 다루는 내 보관함
taskforge는 Obsidian 보관함의 작업과 노트를 다루는 명령줄 할 일 앱입니다. 작업을 조회하고 완료하며, 노트를 만들고 편집하거나, 같은 명령을 셸 스크립트나 에이전트에 맡길 수 있습니다. 앱과 같은 파서를 사용하며 컴퓨터에 실제 마크다운 파일을 씁니다.
CLI냐 MCP 서버냐?
MCP 연결이 없는 셸 환경, 즉 스크립트, cron, CI, 저장소 체크아웃에서 작업하는 코딩 에이전트라면 CLI를 사용하세요. 에이전트가 이미 TaskForge에 MCP 연결을 갖고 있다면 MCP 도구를 우선하세요. 타입이 있고, 에이전트가 스스로 고칠 수 있는 구조화된 오류를 반환하며, PATH에 아무것도 필요하지 않습니다. 둘 다 같은 엔진으로 똑같이 동작하므로, 여러분의 런타임에 이미 연결된 쪽을 고르면 됩니다. 보관함 파일을 손으로 편집하는 것은 최후의 수단입니다.
설치
Node.js로 실행해 보세요(npm 및 npx 포함):
taskforge 명령을 전역으로 설치하세요:
npm/npx가 포함된 Node.js가 필요합니다. npm은 macOS, Windows(x64), Linux(x64, arm64)용 네이티브 바이너리를 설치합니다. TaskForge 앱의 Linux 버전은 아직 없으며, Linux에서는 CLI와 MCP 서버를 쓸 수 있습니다. CLI는 앱과 별도로 설치하며, Homebrew는 더 이상 지원하지 않습니다.
빠른 시작
--vault로 taskforge에 보관함 위치를 알려주거나, 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 |
사용자 지정 필드 key에는 문자, 숫자, 밑줄을 쓸 수 있으므로 priority_label과 area_2 모두 사용할 수 있습니다.
요구 사항 하나: 보관함 안내 파일
taskforge는 TaskForge가 보관함 안에 쓰는 작은 안내 파일인 TaskForge/Settings/dialect.json을 읽습니다. 이 파일은 여러분의 정확한 작업 형식을 설명하므로, CLI는 추측하는 대신 여러분의 방식대로 작업을 편집합니다. TaskForge 3.0 이상에서 보관함을 한 번이라도 열고, 설정 > AI 및 에이전트로 가서 ‘에이전트 파일 생성’을 켜 두세요. 그러면 안내 파일이 기록됩니다. TaskForge/Settings가 기본 위치이며, 기준 폴더 이름은 앱에서 바꿀 수 있습니다.
taskforge가 보관함을 찾지 못하면 보관함을 지정하는 세 가지 방법을 알려줍니다:
- 명령에 --vault /path/to/vault를 전달합니다.
- TASKFORGE_VAULT 환경 변수를 설정합니다.
- TaskForge 3.0 이상에서 보관함을 한 번 열어 TaskForge/Settings/dialect.json이 생기게 한 다음, 보관함 폴더 안에서 실행합니다.
로컬에서만 동작
taskforge는 여러분의 기기에서 실행되며, 지정한 보관함 안의 마크다운 파일만 다룹니다. 계정도, API 키도, 네트워크 호출도 없습니다. 이미 보관함을 동기화하고 있는 iCloud, Dropbox, Obsidian Sync 등이 편집 내용을 다른 기기로 전달합니다.
에이전트가 직접 다루게 하고 싶으신가요?
CLI는 터미널과 스크립트를 위한 것입니다. Claude Desktop이나 다른 MCP 클라이언트가 도구 인터페이스를 통해 작업을 추가하고 완료하게 하려면 MCP 서버를 대신 설정하세요. 같은 보관함, 같은 규칙입니다. 어느 쪽이든 같은 taskforge 바이너리이므로, taskforge mcp --stdio 하나면 MCP 서버로 전환됩니다.
MCP 서버 설정하기 →CLI가 작업을 편집하면, 앱이 그 작업을 목록, 위젯, 알림으로 보여 줍니다.
taskforge는 어떤 터미널에서든 내 보관함에 씁니다. TaskForge는 같은 파일을 휴대폰과 데스크톱의 목록, 위젯, 알림으로 바꿔줍니다. iPhone, iPad, Mac, Android, Windows에서 무료로 다운로드할 수 있습니다.
