akiflow

Akiflow Skill

Akiflow API v5를 Python CLI 스크립트로 조작합니다. stdlib만 사용, 외부 의존성 없음.

CLI 경로

${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py

사용 가능 명령

명령	설명	예시
auth	인증 설정 (브라우저 자동 추출)	python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py auth
auth --token	JWT 토큰 수동 입력	python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py auth --token "eyJ..."
add	태스크 생성	python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py add "PR 리뷰하기"
list	태스크 목록	python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py list --today
done	태스크 완료	python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py done TASK_ID
delete	태스크 삭제	python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py delete TASK_ID
move	날짜 변경	python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py move TASK_ID 2026-03-25
labels	라벨(프로젝트) 목록	python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py labels
check	인증 상태 확인	python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py check

add 명령 옵션

옵션	설명	예시
--date, -d	예정일	add "회의 준비" -d 2026-03-25
--description	설명	add "리뷰" --description "PR #123 코드 리뷰"
--priority, -p	우선순위 (0~3)	add "긴급 배포" -p 3
--label, -l	라벨(프로젝트) 이름	add "데이터 정리" -l "Work"

우선순위: 0=없음, 1=낮음, 2=중간, 3=높음

list 명령 옵션

옵션	설명
--today, -t	오늘 태스크만
--date, -d	특정 날짜 필터 (YYYY-MM-DD)
--all, -a	완료/삭제 포함
--limit, -n	최대 개수 (기본 50)

실행 워크플로우

1. 사용자 요청 분석: 어떤 Akiflow 작업인지 파악
2. 명령 구성: 적절한 서브커맨드 + 인자 조합
3. Bash로 실행: python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py <command> <args>
4. 결과 요약: 사용자에게 읽기 쉬운 형태로 보고

태스크 생성 시 규칙

• 사용자가 날짜를 명시하지 않으면 --date에 오늘 날짜 사용
• 한국어 제목 그대로 사용 가능
• ID는 앞 8자리만으로도 매칭 가능 (done, delete, move 시)

초기 설정 (최초 1회)

1. 브라우저에서 https://web.akiflow.com 로그인 상태 확인
2. 자동 추출 실행:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py auth

3. 자동 추출 실패 시 수동 입력:
   • 브라우저 개발자 도구 → Application → IndexedDB → akiflow 검색
   • JWT 토큰 (eyJ...로 시작) 복사

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py auth --token "eyJ..."

4. 연결 확인:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/akiflow-cli.py check

인증 정보

• 저장 위치: ~/.config/af/credentials.json
• 토큰 만료: ~30분 (자동 갱신 시도)
• 갱신 실패 시: auth 재실행

Tool Dependencies

Tool	Purpose
Bash	CLI 스크립트 실행

사용 예시

/akiflow PR 리뷰하기 태스크 추가해줘
/akiflow 오늘 할 일 목록 보여줘
/akiflow "데이터 파이프라인 점검" 내일로 추가해줘, 우선순위 높음
/akiflow 이 태스크 완료 처리해줘
/akiflow 라벨 목록 보여줘