---
{
  "title": "Workflowy CLI",
  "intro": "터미널, 스크립트, AI 에이전트에서 Workflowy를 사용하세요."
}
---

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

소스 코드와 최신 릴리스는 [Workflowy CLI GitHub 저장소](https://github.com/rodolfo-terriquez/workflowy-cli)에서 확인할 수 있습니다.

# 할 수 있는 작업

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

# 필요한 항목

- [workflowy.com/api-key](https://workflowy.com/api-key/)에서 발급한 Workflowy API 키
- macOS, Linux 또는 Windows의 터미널

# 설치 방법

## macOS 및 Linux

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

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

## Windows

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

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

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

# Workflowy 계정 연결하기

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

```bash
wf login
wf cache:sync
wf doctor
```

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

# CLI 사용 시작하기

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

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

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

```bash
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 계정의 최신 사본이 필요할 때 동기화하세요.

```bash
wf cache:sync
```

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

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

# 여러 계정 연결하기

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

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

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

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

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

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

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

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

```bash
wf mcp
```

설치된 `wf` 바이너리를 `mcp` 인수로 실행하도록 MCP 클라이언트를 설정하세요. 서버가 CLI와 같은 계정 및 캐시를 사용하도록 먼저 `wf login`과 `wf cache:sync`를 실행하세요. 설정 예시와 고급 MCP 옵션은 [Workflowy CLI README](https://github.com/rodolfo-terriquez/workflowy-cli#readme)를 참고하세요.

# CLI 업데이트하기

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

```bash
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](https://github.com/rodolfo-terriquez/workflowy-cli/issues)에 등록하세요.