CLI 명령어 가이드

AI4PKM CLI의 주요 명령어를 빠르게 참조할 수 있는 가이드입니다.

⚠️ Breaking Change: -t/--trigger-agent 플래그가 trigger 서브커맨드로 변경되었습니다.

• 기존: ai4pkm -t → 신규: ai4pkm trigger
• 기존: ai4pkm -t EIC → 신규: ai4pkm trigger EIC

기본 명령어

사용법

Usage: ai4pkm [OPTIONS] COMMAND [ARGS]
       ai4pkm [AGENT_ABBREVIATION]

도움말 및 정보

# 전체 도움말
ai4pkm --help

# 현재 설정 확인
ai4pkm --show-config

Orchestrator 명령어

Orchestrator는 파일 감시, 에이전트 자동 실행, 스케줄링을 담당하는 핵심 시스템입니다.

실행 및 관리

# Orchestrator 시작 (데몬 모드)
ai4pkm -o
ai4pkm --orchestrator

# 디버그 모드로 실행
ai4pkm -o -d
ai4pkm --orchestrator --debug

# 상태 확인
ai4pkm --orchestrator-status

시작 시 동작:

• orchestrator.yaml의 input_path 폴더 감시 시작
• 파일 생성/수정 감지 → 자동 에이전트 실행
• Cron 스케줄에 따라 주기적 에이전트 실행
• Poller 시작 (외부 데이터 동기화)

종료: Ctrl+C

에이전트 명령어

목록 조회

# 사용 가능한 에이전트 목록
ai4pkm --list-agents

출력 예:

Available Agents:
  1. Enrich Ingested Content (EIC)
     - Executor: claude_code
     - Input: Ingest/Clippings
     - Output: AI/Articles
     - Status: Active

  2. Generate Daily Roundup (GDR)
     - Executor: claude_code
     - Cron: 0 1 * * * (Daily at 1 AM)
     - Output: AI/Roundup
     - Status: Scheduled

수동 실행 (trigger 서브커맨드)

# 대화형 에이전트 선택 및 실행
ai4pkm trigger

# 에이전트 직접 실행
ai4pkm trigger EIC
ai4pkm trigger GDR

# 작업 디렉터리 지정과 함께
ai4pkm -w /path/to/vault trigger EIC

약어로 직접 실행

# 에이전트 약어로 바로 실행 (trigger 없이도 가능)
ai4pkm EIC
ai4pkm GDR

추가 옵션

작업 디렉터리 지정

# 특정 Vault에서 실행
ai4pkm -w /path/to/vault
ai4pkm --working-dir /path/to/vault

단일 프롬프트 실행

# 일회성 프롬프트 실행
ai4pkm -p "오늘 할 일 정리해줘"
ai4pkm --prompt "분석해줘"

세션 관리

# 기존 세션 이어서 사용
ai4pkm -s my-session
ai4pkm --session-id my-session

디버깅

디버그 모드

# 디버그 로그 활성화
ai4pkm -d
ai4pkm --debug

# 디버그 + Orchestrator
ai4pkm -o -d

디버그 출력 예:

[DEBUG] Loading orchestrator.yaml
[DEBUG] Parsing nodes section
[DEBUG] Found agent: EIC
[DEBUG] Input path: Ingest/Clippings
[DEBUG] Starting file monitor
[INFO] Orchestrator running

로그 확인

# 로그 파일 위치
cat _Settings_/Logs/ai4pkm.log

# 실시간 로그 모니터링
tail -f _Settings_/Logs/ai4pkm.log

실전 예제

기본 워크플로우

# 1. Vault 디렉터리로 이동
cd /path/to/your/vault

# 2. 설정 확인
ai4pkm --show-config

# 3. Orchestrator 시작
ai4pkm -o

# (별도 터미널에서) 웹 클리핑 저장
echo "# My Article" > Ingest/Clippings/article.md

# → EIC 에이전트가 자동 실행됨

수동 에이전트 실행

# 1. 에이전트 목록 확인
ai4pkm --list-agents

# 2. 대화형으로 에이전트 선택 및 실행
ai4pkm trigger

# 또는 약어로 직접 실행
ai4pkm GDR

# 3. 결과 확인
ls AI/Roundup/

백그라운드 실행

# Linux/macOS
nohup ai4pkm -o > orchestrator.log 2>&1 &

# 상태 확인
ai4pkm --orchestrator-status

# 로그 모니터링
tail -f orchestrator.log

환경 변수

일부 설정은 환경 변수로 오버라이드 가능합니다:

# Vault 경로 지정
export AI4PKM_VAULT_PATH="/path/to/vault"

# 디버그 레벨
export AI4PKM_DEBUG=1

# Executor 경로
export CLAUDE_PATH="/usr/local/bin/claude"

명령어 요약

옵션

서브커맨드

직접 실행

ai4pkm [AGENT_ABBREVIATION]  # 약어로 에이전트 직접 실행
ai4pkm EIC                   # 예: EIC 에이전트 실행
ai4pkm trigger EIC           # trigger 서브커맨드로도 실행 가능

참조

• (0) Orchestrator 개요 - 시스템 아키텍처 (개발자용)
• (4) Orchestrator 설정 - 설정 파일 가이드
• (1) Poller 시스템 가이드 - 외부 데이터 연동 (개발자용)

학습 경로