opticalflow
/opticalflow
Drive the OpticalFlow app on this Mac from the shell with the `opticalflow` command: list, add, move, and complete tasks, run focus sessions and breaks, start or stop screen recordings, read a project's kanban board, and export recordings. Use when the user asks about their tasks, sessions, or recordings, or names OpticalFlow.
- Author
- Ahmad4041 ↗
- Repository
- OpticalFlow ↗
- Licence
- MIT
- Last repository change
- 05.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 05.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Drive the OpticalFlow app on this Mac from the shell with the `opticalflow` command: list, add, move, and complete tasks, run focus sessions and breaks, start or stop screen recordings, read a project's kanban board, and export recordings. Use when the user asks about their tasks, sessions, or recordings, or names OpticalFlow.
Original author description
Drive the OpticalFlow app on this Mac from the shell with the `opticalflow` command: list, add, move, and complete tasks, run focus sessions and breaks, start or stop screen recordings, read a project's kanban board, and export recordings. Use when the user asks about their tasks, sessions, or recordings, or names OpticalFlow.
How it works
- Rules
- Main commands
- MCP (Claude Desktop)
SKILL.md preview
--- name: opticalflow description: Drive the OpticalFlow app on this Mac from the shell with the `opticalflow` command: list, add, move, and complete tasks, run focus sessions and breaks, start or stop screen recordings, read a project's kanban board, and export recordings. Use when the user asks about their tasks, sessions, or recordings, or names OpticalFlow. --- # OpticalFlow `opticalflow` runs commands in the OpticalFlow app. Changes show in its window at once. If the app is closed, the command opens it in the background. ## Rules - Always add `--json` and read the JSON. Exit 0 is ok; otherwise read `error.code` and `error.message`, and do what the message says. - Find ids with `opticalflow tasks list` or `--search`. An id is 8 characters. Projects also go by name. - `tasks delete` only reports what it would do. Show the user that report and ask before you run it again with `--yes`. - `record start` shows the system picker: a person must pick what to capture. Never loop on it. - To try something without real data, add `APP_STORE=/tmp/opticalflow-test.store` in front of the command. ## Main commands | Command | Does | | --- | --- | | `opticalflow status --json` | Open page, counts, the running session, recording state | | `opticalflow tasks list [--page today] [--project P] [--column doing] [--search T] --json` | Find tasks | | `opticalflow tasks add --title T [--project P] [--due tomorrow] [--priority high] [--record] --json` | Add one | | `opticalflow tasks update <id> [--priority high] [--notes "…"] [--due fri] --json` | Change one; urgent means `--priority high` | | `opticalflow agent say "make the login loop urgent" --json` | Send a sentence to the voice agent | | `opticalflow tasks add --title "Send the invoice" --deadline fri --repeat monthly --json` | A hard date apart from the plan; a repeat rule | | `opticalflow record mark --title "The bug appears" --json` | A chapter marker in the running recording | | `opticalflow projects update <name> --repo <path>` then `opticalflow tasks handoff <id> --json` | Run an agent on a task in its own worktree; `agent jobs` shows progress | | `opticalflow tasks move <id> --to doing` | Board column or page: backlog, todo, doing, done, inbox, today, someday, a project | | `opticalflow session start --task <id> --json` | Start a focus session (and the recorder when the task records) | | `opticalflow projects board <name> --json` | A project's board, tasks per column | | `opticalflow recordings chapters <id>` | The YouTube chapter list | | `opticalflow open <page> [--board]` | Show a page in the window | Everything else: `opticalflow help`, and `opticalflow help <command>` for its options. ## MCP (Claude Desktop) ``` claude mcp add --scope user opticalflow -- ~/Applications/OpticalFlow.app/Contents/MacOS/OpticalFlow mcp ```
Versions
The database has no other skills named opticalflow.
Database snapshot: 13.11.2026 · package version ec5aa7283051 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100open-board
Opens the Cowork Tasks kanban board as an artifact in the Claude desktop app, reusing the same artifact every time. Use when the user asks to open, show, or check their board, kanban, tasks, or inbox. - 86what-have-we-done-today
Use when a recap of today's sessions, cron, and kanban helps. - 95obsidian-tracker-done
Complete a task and move to Done on kanban board. Use when the user invokes /done. - 90amazonmusic
Drive the Amazon Music app on this Mac from the shell with the `amazonmusic` command: show the current track, list the Up Next queue, play, pause, skip, seek, like, shuffle, repeat, play similar music, and open a music.amazon.com page. Use when the user asks what is playing or… - 100markdown-task-manager
Use when managing tasks, the system is a Kanban task manager based on local Markdown files (`kanban.md` and `archive.md`). It follows a strict format compatible with the task-manager.html web application. - 95obsidian-tracker-task
Create a new task in an Obsidian project with kanban board. Use when the user invokes /task.