{"id":24730182,"url":"https://github.com/makerflow/cli","last_synced_at":"2025-10-09T23:30:44.670Z","repository":{"id":48241557,"uuid":"385076333","full_name":"makerflow/cli","owner":"makerflow","description":"Makerflow is a deep work  and collaboration assistant for developers. Get in the zone without hiding away from your product manager, designer or other teammates!","archived":false,"fork":false,"pushed_at":"2024-02-20T15:17:55.000Z","size":16871,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-06T19:27:28.918Z","etag":null,"topics":["distraction-blocker","distraction-free","do-not-disturb","google-calendar","macos","meetings","productivity","pull-requests","slack","slack-status"],"latest_commit_sha":null,"homepage":"https://makerflow.co","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/makerflow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-11T23:53:46.000Z","updated_at":"2024-08-03T19:01:44.000Z","dependencies_parsed_at":"2022-08-24T10:51:27.442Z","dependency_job_id":null,"html_url":"https://github.com/makerflow/cli","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerflow%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerflow%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerflow%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerflow%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/makerflow","download_url":"https://codeload.github.com/makerflow/cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235879933,"owners_count":19059722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["distraction-blocker","distraction-free","do-not-disturb","google-calendar","macos","meetings","productivity","pull-requests","slack","slack-status"],"created_at":"2025-01-27T15:52:37.096Z","updated_at":"2025-10-09T23:30:38.170Z","avatar_url":"https://github.com/makerflow.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Makerflow 💻 🌊\n\nMakerflow is a deep work  and collaboration assistant for developers. Get in the zone without \nhiding away from your product manager, designer or other developers on the team!\n\n![](docs/media/toggle-demo.gif)\n\n## Table of contents\n\n1. [Features](#features)\n1. [Installation](#installation)\n1. [Usage](#usage)\n   1. [Flow Mode](#flow-mode)\n   1. [Tasks](#tasks)\n   1. [Breaks](#breaks)\n   1. [Events (from Google Calendar)](#events-from-google-calendar)\n\n## Features\n\n#### With a [single command](#flow-mode) (`makerflow toggle`):\n1. 🔕 Toggle \"Do Not Disturb\" mode on macOS.\n1. 🙅 Close/open distracting chat apps like Slack, Discord, MS Teams, Telegram, WhatsApp, and Messages.\n1. 🛑 Block/unblock distracting websites with the help of Makerflow [Chrome](https://chrome.google.com/webstore/detail/codmnedpgifnlanopnolihpobepaafic) or [Firefox](https://addons.mozilla.org/en-US/firefox/addon/makerflow/) extensions\n1. 💬 Update/clear your Slack status automatically to let your co-workers know when \n   1. you are trying to do deep work and will be slow to respond. Status is set to 💻\n   1. or, when you are on a [break](#breaks). Status is set to one of these emojis ☕️ 🍵 🥪 🥤 🚶 🏃 💪 🏥 👶 ⏸ ([more info](#providing-type-of-break))\n\n#### Plus, other commands to\n1. 📋 Get a list of your [tasks](#tasks) (`makerflow tasks todo`) like pull requests from GitHub or Bitbucket\n1. ✅ and mark them as done (`makerflow tasks done`)\n1. 📅 Interact with [events from Google Calendar](#events-from-google-calendar) by\n   1. listing them (`makerflow events list`)\n   1. or, joining them (`makerflow events join`)\n\n\n## Installation\n\nInstall with `npm install -g makerflow-cli`\n\nOnce installed, run\n1. `makerflow config token` to set your API token.\n2. `makerflow config kill` to set which apps are automatically closed when Flow Mode is started and reopened \nwhen it is ended\n\n### Pre-requisites\n\n1. MacOS. \n1. A free Makerflow account. Sign up at https://makerflow.co\n1. API token from https://app.makerflow.co/settings#api\n\n## Usage\n\nGet a list of available commands with `makerflow --help`\n\nRun any available command with the `--help` flag to get more usage details about it.\nFor example, run `makerflow toggle --help` to get usage information about the `toggle` command\n\n### Flow Mode\n\nStarting Flow Mode will: \n1. 🔕 Turn on \"do-not-disturb\" mode on macOS to block your notifications and \n   prevent distractions.\n1. 💬 If you have your Slack workspace connected to Makerflow, it will automatically set your \n   Slack status to let your teammates know you might be slow to respond.\n1. 🙅 Close distracting chat apps like Slack, Discord, MS Teams, Telegram, WhatsApp, and Messages\n   1. Once, if you ran `makerflow toggle --kill`\n   1. Everytime, if you configured it to do so with `makerflow config kill`\n1. 🛑 Block distracting websites if you have Makerflow [Chrome](https://chrome.google.com/webstore/detail/codmnedpgifnlanopnolihpobepaafic) or [Firefox](https://addons.mozilla.org/en-US/firefox/addon/makerflow/) extensions installed.\n\nStopping Flow Mode will reverse all the above actions.\n\n#### Commands\n`makerflow toggle` - Start/stop Flow Mode\n\n`makerflow toggle --kill` - Start/stop Flow Mode and close/open chat apps. Only apps that were closed at the time of starting Flow Mode are reopened.\n\n#### Demo\n\n![](docs/media/toggle-demo.gif)\n\n\n### Tasks\n\nTasks show up in Makerflow by connecting with your other collaboration tools like Slack, GitHub or Bitbucket.\n\nYou can connect these tools with Makerflow from the \"[Setup Integrations](https://app.makerflow.co/integrations)\" page on the website.\n\n#### Commands\n\n`makerflow tasks todo` - See a list of pending tasks like pull requests from GitHub/Bitbucket.\n\n`makerflow tasks done` - list notifications/pull requests and mark one or more tasks as done\n\n#### Demo\n\n![](docs/media/tasks-demo.gif)\n\n\n### Breaks\n\nBreaks are a quick way to set your Slack status and let your coworkers know when you are \naway on a break.\n\n##### Providing type of break\n\nIf you pass a `--reason` argument, Makerflow will automatically set an appropriate status and emoji \nfor you on Slack. For instance, if you run `makerflow break start --reason=lunch`, it will set 🥪 \nemoji as your status icon. If you don't supply a reason, your status will be set to ⏸.\n\nReasons currently supported are lunch (🥪), coffee (☕️), tea (🍵), beverage (🥤), walk (👟), run (🏃), workout (💪), \nchild (👶), and doctor (🏥).\n\n##### Commands\n\n`makerflow break start` - Start a beak. Sets your Slack status emoji to ⏸\n\n`makerflow break start --reason=\u003ctype\u003e` - Start a break with a specific reason. Supported values for reason are one of `lunch`, `coffee`, `tea`, `beverage`, `walk`, `run`, `workout`, `child`, `doctor`\n\n`makerflow break stop` - Finish your break. Slack status is cleared.\n\n#### Demo\n\n![](docs/media/break-demo.gif)\n\n\n### Events (from Google Calendar)\n\nInteract with events from connected Google Calendars. You can your calendars with Makerflow from the \n\"[Setup Integrations](https://app.makerflow.co/integrations)\" page on the website.\n\n#### Commands\n`makerflow events list` - will list recently ended, ongoing and upcoming events from Google Calendar.\n`makerflow events join` - will open a currently ongoing event's, or, the next upcoming event's Google Meet\n`makerflow events join --next --wait` - Open next event's Google Meet when the event starts\n\n#### Demo\n\n![](docs/media/events-demo.gif)\n\n\n## Upcoming\n\nMakerflow VS Code plugin is coming soon to trigger \"Flow Mode\" automatically or from the command palette.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakerflow%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmakerflow%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakerflow%2Fcli/lists"}