// Manage Akiflow tasks from CLI. Use when creating, listing, completing tasks, managing projects, or viewing calendar/time blocks. Credential extraction from browser—no API keys needed.
| name | akiflow-cli |
| description | Manage Akiflow tasks from CLI. Use when creating, listing, completing tasks, managing projects, or viewing calendar/time blocks. Credential extraction from browser—no API keys needed. |
| metadata | {"openclaw":{"emoji":"📋","requires":{"bins":["af"]}}} |
Manage Akiflow tasks directly from the command line.
| 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.
바이너리 설치됨: /opt/homebrew/bin/af (또는 which af)
최초 인증:
af auth # Chrome에서 토큰 자동 추출
af auth status # 인증 상태 확인
Credentials 저장 위치: ~/.config/af/credentials.json
증상:
AuthError: No credentials found 에러401 Unauthorized 응답대처 순서:
먼저 Chrome에서 Akiflow 로그인 확인
# Chrome에서 https://web.akiflow.com 접속하여 로그인 상태 확인
# 로그아웃 되어있으면 로그인
토큰 재추출
af auth
# "Found 1 token(s) from: chrome" 메시지 확인
인증 상태 확인
af auth status
# "Authenticated" 출력되면 성공
여전히 실패 시
af auth 다시 실행| 에러 | 원인 | 해결 |
|---|---|---|
No credentials found | 토큰 없음 | af auth 실행 |
Token expired | 만료됨 | Chrome에서 Akiflow 접속 후 af auth |
401 Unauthorized | 토큰 무효 | 위와 동일 |
Network error | 네트워크 | 인터넷 연결 확인 |
af auth # Extract credentials from browser
af auth status # Check auth status
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
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
af do 1 # Complete by short ID (requires af ls first)
af do "full-uuid-here" # Complete by full UUID
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
af project ls # List all projects
af project create "Project Name" # Create new project
af project delete "Project Name" # Delete project
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
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.
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
af add "Review PR #123" -t # Add to today
af add "Follow up with client" -d "monday" # Schedule for next week
af ls # Review remaining tasks
af task snooze 2 --duration "1d" # Push to tomorrow
af do 1 # Mark as done
af cal --free # Find available slots
af block 2h "Deep work" --start "09:00"
af block 1h "Email" --start "14:00"
af project ls # List projects
af ls --project "Work" # View project tasks
af add "New feature" --project "Work" -d "friday"
Supported formats:
today, tomorrow, yesterdaymonday, tuesday, ... (next occurrence)next week, next monthin 2 hours, in 3 daysmarch 15, 2026-03-15friday 10am, tomorrow 14:00All commands output human-readable format by default.
af auth # Re-extract from browser
af auth status # Verify authentication
af ls # Refresh task cache first
af do 1 # Now works