{"id":18267719,"url":"https://github.com/maebert/bragmaster","last_synced_at":"2025-07-25T18:34:24.655Z","repository":{"id":141747354,"uuid":"52320464","full_name":"maebert/bragmaster","owner":"maebert","description":null,"archived":false,"fork":false,"pushed_at":"2016-07-17T20:34:47.000Z","size":17,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-25T08:49:52.613Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maebert.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-02-23T01:41:58.000Z","updated_at":"2016-03-01T20:08:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"c6f84eca-3a1b-4778-bd57-784a5dc88bc6","html_url":"https://github.com/maebert/bragmaster","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/maebert/bragmaster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maebert%2Fbragmaster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maebert%2Fbragmaster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maebert%2Fbragmaster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maebert%2Fbragmaster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maebert","download_url":"https://codeload.github.com/maebert/bragmaster/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maebert%2Fbragmaster/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267046244,"owners_count":24026899,"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","status":"online","status_checked_at":"2025-07-25T02:00:09.625Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-11-05T11:28:37.054Z","updated_at":"2025-07-25T18:34:24.596Z","avatar_url":"https://github.com/maebert.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BRAGMaster 3000\n\nBRAGMaster is a tool to help you facilitate Business Re-Evaluation and Enhancement Groups (BRAGs).\n\n![Bragging](http://i.giphy.com/xT77Y5UUIdbefJL0PK.gif)\n\nTo use a BRAGMaster, you need a BRAG file. The BRAG file is a simple markdown file. Each top-level header (`#`) seperates the the section for one user (the email address is optional). Each user has a Goals section (`## Goals`) that contains their medium term life and career goals. Each BRAG session is another section under the users. Tasks marked with [X] completed. Everything after `--` is a comment. Example:\n\n```md\n# Manuel \u003cmanuel@1450.me\u003e\n\n## Goals\n\n- [ ] Run a marathon\n- [ ] Make my company profitable\n\n## Recurring\n\n- [ ] Meditate daily\n\n## 2016-02-06\n\n- [X] Run 20k on the weekend -- Did it in 2:06:12\n- [ ] Submit 5 pull requests\n\n# Stan\n\n....\n```\n\n## Usage\n\nYou either need to set the or supply a file with `-f path_to_brag_file` every time.\n\n- `brag.py users`: Print all users and their e-mail addresses\n- `brag.py current`: Print current tasks for everybody\n- `brag.py last`: Print tasks for last brag for everybody\n- `brag.py run`: Runs a brag session\n\nOptions:\n- `-f path_to_brag_file` is required if you haven't set the  `$BRAG_FILE` environment variable (recommended)\n- `-u name[,other_name]` limits the output to certain users\n\n## Running a brag session\n\n```\nbrag.py run\n```\n\nYou can specify the editor with the `-e` option or setting the `$BRAG_EDITOR` environment variable, e.g.\n\n- IA Writer: `open -b pro.writer.mac -Wn`\n- Sublime Text: `subl -w` (the `-w` flag prevents waits for the window to be closed before the script continues)\n- vim: `vim`\n\n## Sending automated reminders\n\n`brag_mail.py` will use [Mandrill](http://www.mandrillapp.com) send an email to everyone to remind them of this week's task. To do this, you must set the `$MANDRILL_KEY` environment variable to your API key or pass it with the `-k` option.\n\n```\nDear Manuel,\n\nToday is Thursday, two more days to get your shit together and be productive. Gentle automated reminder, here are your tasks for this week:\n\n- [ ] Run 20k on the weekend\n- [ ] Submit 5 pull requests\n\nThis email was automatically generated by BRAGMaster 3000 - https://github.com/maebert/bragmaster\n```\n\nI recommend creating a crontab to do this automatically every Thursday at 9am:\n\n```sh\n0 9 * * 4 brag_mail.py -k YOUR_API_KEY -f YOUR_BRAG_FILE\n```\n\n## Managing Users\n\nYou can add `(inactive)` to the username in your brag file to keep them from showing up in `brag stats` and `brag run` like this:\n\n```\n# Manuel \u003cmanuel@1450.me\u003e (inactive)\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaebert%2Fbragmaster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaebert%2Fbragmaster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaebert%2Fbragmaster/lists"}