Workflowy CLI

터미널, 스크립트, AI 에이전트에서 Workflowy를 사용하세요.

Markdown으로 보기

Workflowy CLI(wf)는 Workflowy 계정을 읽고, 검색하고, 정리하고, 편집하는 오픈 소스 명령줄 도구 모음입니다. 빠른 접근을 위한 로컬 캐시, 자동화 명령, 스크립트와 에이전트를 위한 기계 판독 가능 출력, 내장 MCP 서버가 포함되어 있습니다.

소스 코드와 최신 릴리스는 Workflowy CLI GitHub 저장소에서 확인할 수 있습니다.

할 수 있는 작업

  • 터미널에서 Workflowy 계정 읽고 검색하기
  • 노드 추가, 업데이트, 이동, 완료, 삭제하기
  • @inbox, @today, @tomorrow 같은 내장 위치 사용하기
  • 북마크와 경로를 사용해 계정의 특정 부분 지정하기
  • 아웃라인 내보내기, 할 일과 태그 찾기, 최근 변경 사항 검토하기
  • 여러 Workflowy 계정을 연결하고 각 계정에 별도의 로컬 캐시 유지하기
  • 스크립트와 AI 에이전트를 위한 구조화된 JSON 반환하기
  • MCP 호환 AI 도구를 Workflowy에 직접 연결하기

필요한 항목

설치 방법

macOS 및 Linux

다음 명령을 터미널에 복사해 붙여 넣으세요.

curl -fsSL https://github.com/rodolfo-terriquez/workflowy-cli/releases/latest/download/install.sh | bash

Windows

다음 명령을 PowerShell에 복사해 붙여 넣으세요.

irm https://github.com/rodolfo-terriquez/workflowy-cli/releases/latest/download/install.ps1 | iex

설치 프로그램은 운영체제와 프로세서를 감지하고, 최신 사전 빌드 버전을 다운로드하고, 가능한 경우 wf 명령을 PATH에 추가합니다.

Workflowy 계정 연결하기

설치 후 다음 명령을 실행하세요.

wf login
wf cache:sync
wf doctor

wf login은 Workflowy API 키를 화면에 표시하지 않고 입력을 요청합니다. wf cache:sync는 빠른 읽기와 검색을 위해 아웃라인의 로컬 사본을 다운로드합니다. wf doctor는 로그인, 설정, 캐시, 설치를 확인합니다.

CLI 사용 시작하기

위치를 읽거나 계정을 검색하세요.

wf node:read @inbox
wf node:read @today --depth 3
wf search "quarterly planning"
wf targets

항목을 추가하고 관리하세요.

wf node:add @inbox "Draft project brief" --type todo
wf node:complete "@inbox/Draft project brief"
wf node:move "@today/Review roadmap" @inbox
wf node:update "@inbox/Follow up" --note "Waiting on a reply"

대상을 받는 명령에는 내장 위치, wf targets가 반환한 북마크, 노드 ID 또는 @today/Meetings/Launch review 같은 경로를 사용할 수 있습니다.

전체 명령 목록을 보려면 wf --help를 실행하고, 명령의 옵션을 보려면 해당 명령 뒤에 --help를 추가하세요.

로컬 결과를 최신 상태로 유지하기

대부분의 읽기 및 검색 명령은 로컬 SQLite 캐시를 자동으로 사용합니다. Workflowy 계정의 최신 사본이 필요할 때 동기화하세요.

wf cache:sync

한 번의 요청에서 캐시를 사용하지 않으려면 지원되는 명령에 --live를 사용하세요.

wf node:read @inbox --live
wf search "launch notes" --live

여러 계정 연결하기

로그인할 때 각 계정에 짧은 로컬 이름을 지정하세요.

wf login --account personal
wf login --account work
wf account:list
wf account:switch work
wf account:current

각 계정은 자체 로컬 캐시를 유지합니다. 기본 계정을 변경하지 않고 단일 명령에 사용할 계정을 선택할 수 있습니다.

wf --account personal cache:sync
wf --account work node:add @inbox "Follow up with the team"

스크립트 및 AI 에이전트와 CLI 사용하기

--agent를 추가하면 구조화된 결과와 오류가 포함된 기계 판독 가능 JSON을 반환합니다.

wf search "project roadmap" --agent
wf node:read @today --depth 3 --agent

CLI에는 로컬 MCP 서버도 포함되어 있습니다.

wf mcp

설치된 wf 바이너리를 mcp 인수로 실행하도록 MCP 클라이언트를 설정하세요. 서버가 CLI와 같은 계정 및 캐시를 사용하도록 먼저 wf login과 wf cache:sync를 실행하세요. 설정 예시와 고급 MCP 옵션은 Workflowy CLI README를 참고하세요.

CLI 업데이트하기

다음 명령으로 새 릴리스를 확인하거나 설치하세요.

wf self:update --check
wf self:update

보안 및 문제 해결

  • API 키가 셸 기록에 저장되지 않도록 wf login의 대화형 입력을 사용하세요.
  • 검색 결과가 오래된 것 같으면 wf cache:sync를 실행하거나 --live를 사용하세요.
  • 명령이 잘못된 계정을 사용하면 wf account:current를 확인하고 wf account:switch <name>으로 전환하세요.
  • 설치 후 wf를 찾을 수 없으면 새 터미널을 열고 설치 디렉터리가 PATH에 있는지 확인하세요.
  • 설치, 인증, 설정, 캐시를 확인하려면 wf doctor를 실행하세요.
  • 버그와 기능 요청은 저장소의 GitHub Issues에 등록하세요.
다음 글
Workflowy API로 AI 에이전트 구축하기
맞춤형 에이전트, 통합 또는 자동화가 필요하면 Workflowy API를 직접 사용하세요.