Akiflow CLI
Manage Akiflow tasks directly from the command line.
Why use this?
| Feature | Web App | Akiflow CLI |
|---|---|---|
| Speed | Browser-based | Instant from terminal |
| OAuth setup | N/A | Not needed |
| API keys | N/A | Not needed |
| Credential source | Manual login | Browser token extraction |
Use this when you want fast task management without leaving your terminal.
Setup
바이너리 설치됨: /opt/homebrew/bin/af (또는 which af)
최초 인증:
af auth # Chrome에서 토큰 자동 추출
af auth status # 인증 상태 확인
Credentials 저장 위치: ~/.config/af/credentials.json
토큰 만료 대처 (중요!)
자동 갱신
- CLI가 refresh token으로 자동 갱신 시도
- 대부분의 경우 사용자 개입 없이 작동
수동 재인증이 필요한 경우
증상:
AuthError: No credentials found에러401 Unauthorized응답- API 호출 실패
대처 순서:
먼저 Chrome에서 Akiflow 로그인 확인
# Chrome에서 https://web.akiflow.com 접속하여 로그인 상태 확인 # 로그아웃 되어있으면 로그인토큰 재추출
af auth # "Found 1 token(s) from: chrome" 메시지 확인인증 상태 확인
af auth status # "Authenticated" 출력되면 성공여전히 실패 시
- Chrome 완전히 종료 후 재시작
- Akiflow 웹에서 로그아웃 → 재로그인
af auth다시 실행
에러별 대처
| 에러 | 원인 | 해결 |
|---|---|---|
No credentials found |
토큰 없음 | af auth 실행 |
Token expired |
만료됨 | Chrome에서 Akiflow 접속 후 af auth |
401 Unauthorized |
토큰 무효 | 위와 동일 |
Network error |
네트워크 | 인터넷 연결 확인 |
Authentication
af auth # Extract credentials from browser
af auth status # Check auth status
Task Commands
List Tasks
af ls # List today's tasks
af ls --inbox # List inbox (unscheduled tasks)
af ls --project "Work" # List by project
af ls --all # List all tasks
Add Tasks
af add "Task title" # Add to inbox
af add "Task title" -t # Add for today
af add "Task title" -d "tomorrow" # Natural language date
af add "Task title" -d "next friday 10am" # Specific date/time
af add "Task title" --duration "2h" # With duration
af add "Task title" --project "Work" # Assign to project
Complete Tasks
af do 1 # Complete by short ID (requires af ls first)
af do "full-uuid-here" # Complete by full UUID
Edit Tasks
af task edit 1 --title "New title" # Edit title
af task move 1 --project "Personal" # Move to project
af task plan 1 -d "tomorrow" # Reschedule
af task snooze 1 --duration "2h" # Snooze
af task delete 1 # Delete
Project Commands
af project ls # List all projects
af project create "Project Name" # Create new project
af project delete "Project Name" # Delete project
Calendar & Time Blocking
af cal # View today's schedule
af cal --free # Find free time slots
af cal -d "tomorrow" # View specific date
af block 1h "Focus time" # Create 1-hour time block
af block 2h "Meeting prep" --start "14:00" # With start time
Short ID System
Running af ls saves task context to ~/.cache/af/last-list.json. This enables short IDs:
af ls # Shows: [1] Task A, [2] Task B, ...
af do 1 # Completes Task A
af task edit 2 --title "Updated" # Edits Task B
Full UUIDs always work as fallback.
Common Workflows
Morning Task Review
af ls # See today's tasks
af ls --inbox # Check inbox for unscheduled items
af task plan 3 -d "today" # Schedule an inbox item for today
Quick Task Capture
af add "Review PR #123" -t # Add to today
af add "Follow up with client" -d "monday" # Schedule for next week
End of Day
af ls # Review remaining tasks
af task snooze 2 --duration "1d" # Push to tomorrow
af do 1 # Mark as done
Time Blocking
af cal --free # Find available slots
af block 2h "Deep work" --start "09:00"
af block 1h "Email" --start "14:00"
Project Management
af project ls # List projects
af ls --project "Work" # View project tasks
af add "New feature" --project "Work" -d "friday"
Natural Language Dates
Supported formats:
today,tomorrow,yesterdaymonday,tuesday, ... (next occurrence)next week,next monthin 2 hours,in 3 daysmarch 15,2026-03-15friday 10am,tomorrow 14:00
Output Format
All commands output human-readable format by default.
Troubleshooting
Token Expired
af auth # Re-extract from browser
af auth status # Verify authentication
Short IDs Not Working
af ls # Refresh task cache first
af do 1 # Now works
Converted and distributed by TomeVault — claim your Tome and manage your conversions.