{"id":13571646,"url":"https://github.com/18F/charlie","last_synced_at":"2025-04-04T08:31:55.266Z","repository":{"id":20899535,"uuid":"24187077","full_name":"18F/charlie","owner":"18F","description":"18F's Slack bot, Charlie. Built on Bolt","archived":false,"fork":false,"pushed_at":"2025-01-31T19:33:49.000Z","size":2779,"stargazers_count":40,"open_issues_count":9,"forks_count":22,"subscribers_count":134,"default_branch":"main","last_synced_at":"2025-01-31T20:27:01.599Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/18F.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.inclusion_bot.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-09-18T12:23:35.000Z","updated_at":"2025-01-16T15:42:10.000Z","dependencies_parsed_at":"2023-01-13T21:12:10.121Z","dependency_job_id":"99933940-873b-4d3f-a951-66737bbc6952","html_url":"https://github.com/18F/charlie","commit_stats":null,"previous_names":[],"tags_count":72,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/18F%2Fcharlie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/18F%2Fcharlie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/18F%2Fcharlie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/18F%2Fcharlie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/18F","download_url":"https://codeload.github.com/18F/charlie/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247147478,"owners_count":20891710,"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":[],"created_at":"2024-08-01T14:01:04.271Z","updated_at":"2025-04-04T08:31:50.258Z","avatar_url":"https://github.com/18F.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Charlie - 18F's Plastic Pal That's Fun to Be With\n\nA Slack app bot used within 18F for fun and work.\n\n- [What all it can do](#what-all-it-can-do)\n  - [Interactive bots](#interactive-bots)\n  - [Non-interactive bots](#non-interactive-bots)\n- [Development](#development)\n- [Public domain](#public-domain)\n\n## What all it can do\n\n### Interactive bots\n\n##### Coffeemate\n\nSchedule virtual coffees with random teammates! Not sure who you should talk to?\nCharlie can help! Say `coffee me` to get put into the virtual coffee queue. As\nsoon as someone else signs up, Charlie will connect you.\n\n##### Dad jokes\n\nCharlie can fetch a joke from\n[Fatherhood.gov](https://www.fatherhood.gov/for-dads/dad-jokes) to brighten up\nyour day. Just say `@Charlie dad joke` to increase your daily joy.\n\n##### Employee resource group invite requests\n\nTo see a list of TTS employee resource and affinity groups that accept automated\ninvitation requests, just ask Charlie! Say `@Charlie ergs` and the bot will send\nyou a direct message listing the groups along with a button for each one.\nClicking the button will send a message to the group letting them know you'd\nlike an invitation!\n\nSome employee resource and affinity groups are not available by automated\ninvitation request. To see the complete list of ERGs and contact information,\nyou can send yourself a direct message that just says `ergs` and Slackbot will\nrespond with that information!\n\n##### Evermarch\n\nEver wondered what day of March 2020, we're currently on? Charlie can tell you.\nJust say `evermarch` in any channel where Charlie is, and it'll let you know.\n\n##### Facts\n\nCharlie knows **_so many_** facts. Dog facts, cat facts, giraffe facts, dolphin\nfacts. There are just so many facts. You can just say `dog fact` (or\n`giraffe fact`, etc.) to get Charlie to share its knowledge with you.\n\n| Key word          | What it does                                      |\n| ----------------- | ------------------------------------------------- |\n| `alan fact`       | Shares a fact about people named Alan             |\n| `alumni dog fact` | Shares a fact about a dog belonging to a TTS alum |\n| `ask ally fact`   | Shares a fact about accessible web development    |\n| `bird fact`       | Shares a fact about a TTS person's bird           |\n| `cat fact`        | Shares a fact about a TTS person's cat            |\n| `dino fact`       | Shares a fact about dinosaurs                     |\n| `dog fact`        | Shares a fact about a TTS person's dog            |\n| `dolphin fact`    | Shares a fact about dolphins                      |\n| `ed simulator`    | Shares a quote from 18F alumni Ed Mullen          |\n| `giraffe fact`    | Shares a fact of dubious truth about giraffes     |\n| `minnesota facts` | Shares a fact about the state of Minnesota        |\n| `park fact`       | Shares a fact about the US National Parks         |\n| `randy fact`      | Shares a fact about 18F staff member Randy        |\n| `screambot`       | Joyfully screams along with you                   |\n| `wisconsin facts` | Shares a fact about the state of Wisconsin        |\n\n##### Fancy font\n\nFeeling fancy, and want your message to reflect that? Charlie is here! Just say\n`fancy font \u003cyour message\u003e` and Charlie will respond with a very fancy version\nof your message. So fancy!\n\n##### Federal holidays\n\nItching for a day off and want to know when the next holiday is? Charlie knows\nall the (standard, recurring) holidays! Just say\n`@charlie when is the next holiday` and Charlie will let you know.\n\n##### Three-paycheck months\n\nDo you look forward to 3-paycheck months to treat yourself to something nice?\nMaybe blue crabs? You deserve nice things, and Charlie can help! Just say\n`@charlie when's the next 3-paycheck month?` (or something similar; Charlie is\nnot too picky) and it'll let you know the next one up!\n\n##### Handbook search\n\nWondering if the [TTS Handbook](https://handbook.tts.gsa.gov) has useful\ninformation for a particular topic but don't want to open your browser? Charlie\ncan help! Just say `@handbook terms` and Charlie will search the Handbook for\n`terms` for you (replace `terms` with whatever you want). If it finds anything,\nit'll post links in a threaded response to your request.\n\n##### HugMe\n\nNeed to see a little hug in your life? Friends from TTS past have left us a gift\nand Charlie will deliver it whenever you need. Just say `@charlie hug me` or\n`@charlie hug bomb \u003cnumber\u003e` to get a little happiness dropped right on your\nscreen.\n\n##### OPM's DC offices status\n\nWorking in DC and want to know if the office is closed due to snow or, perhaps,\nraven attack? Charlie knows all! Say `@charlie opm status` and it will ask OPM\nfor the latest information and then pass that along to you. No more having to\nopen a web browser all by yourself!\n\n##### Procurement glossary\n\nNot sure what a procurement term means? Charlie might be able to help! Say\n`@charlie define \u003cterm\u003e` and it will attempt to look the term up in the\n[18F Procurement Glossary](https://github.com/18f/procurement-glossary)\nand report what it finds.\n\n##### Pug bot\n\nDo you like pugs? Do you want pictures of pugs? Charlie can help! Just say\n`@Charlie pug me` to get a picture of a cute pug, or `@Charlie pug bomb [count]`\nto get a bunch of pug pictures! (You can leave the count out; Charlie will\nsend 3 pictures if you don't ask for a specific number.)\n\n##### Q-Expander bot\n\nEver wonder what the Q\\* initialisms are after everyone's names? Each letter describes where a person fits in the organization. Say `qex [q-initialism]` and get a detailed tree response back.\n\nFor example:\n`qex queaad`\n\nResponse:\n\n```\nQUEAAD\n|||||└──QUEAAD: Chumanjalaal Cohort\n||||└──QUEAA: Engineering\n|||└──QUEA: 18F Chapters\n||└──QUE: 18F\n|└──QU: Office of Clients \u0026 Markets\n└──Q: FAS (TTS)\n```\n\n##### Tock line\n\nWhat Tock line do I bill this project to? Ugh, who can remember? Charlie can!\nIn a channel, you can say `@charlie set tock \u003cnumber\u003e` and Charlie will remember\nthe Tock line for that room. In the future, if you need to know what to bill to,\nsay `@charlie tock` and it will let you know. Handy!\n\n##### US Code Bot\n\nThe law sure is fun, and Charlie can help you look it up! If you drop a citation\nto the US Code, Charlie will attempt to look it up on the\n[Cornell LII](https://www.law.cornell.edu/uscode/text) website and post the text\nin a thread. Handy for you legal eagles!\n\n##### Zen bot\n\nSay `@charlie zen` to get Charlie to fetch a product-, techy-, or code-focused\nmessage of zen. Read it, and breathe.\n\n### Non-interactive bots\n\n##### Helpful tau bot\n\nIf Charlie sees something it recognizes as a time posted into chat, it will send\na message that only you can see, letting you know what that time is in your\ntimezone. Charlie tries really hard.\n\n##### Holiday reminders\n\nOn the business day before a federal holiday, Charlie will post a reminder in\n[#general-talk](https://app.slack.com/client/T025AQGAN/C04KL9ZN2). Take the day\noff, don't do work for the government, and observe it in the way that is most\nsuitable for you!\n\n##### Inclusion bot\n\nCharlie passively listens for [language with racist, ableist, sexist, or other\nexclusionary histories](https://github.com/18F/charlie/blob/main/InclusionBot.md)\n(content warning: the linked document includes words and phrases that the bot\nlistens for, and these words and phrases may be offensive). When it hears such\nwords or phrases, it quietly lets the speaker know and offers some suggestions.\nWhat a great bot, helping nudge us all to thoughtful, inclusive language! We also\nmaintain [a history](https://github.com/18F/charlie/blob/main/CHANGELOG.inclusion_bot.md)\nof the evolution of Inclusion Bot.\n\n##### Optimistic / Angry Tock\n\nAt the end of the work week, Charlie will send a private message to any Tockable\npeople who haven't submitted their Tock yet to remind them to do it. At the\nstart of the next work week, Charlie will send a message to people who still\nhaven't submitted their Tock. Finally, at the end of the first day of the work\nweek, Charlie will send a message to 18F supervisors letting them know about\nanyone whose Tock report is late.\n\n##### Travel team\n\nDid you know that the TTS Travel team takes weekends and holidays too? It's\ntrue, they do! And Charlie knows it too. If you drop a question or comment in\nthe travel channel on a closed day, Charlie will remind you that the office is\nclosed and offer some helpful tips to get you through. It will also let you know\nwhen the Travel team will be back in the office!\n\n## Development\n\nSee [the wiki](https://github.com/18F/charlie/wiki) for developer documentation\nand our [contributing docs](CONTRIBUTING.md) for contribution guidelines\n\n## Public domain\n\nThis project is in the worldwide [public domain](LICENSE.md). As stated in [CONTRIBUTING](CONTRIBUTING.md):\n\n\u003e This project is in the public domain within the United States, and copyright and related\n\u003e rights in the work worldwide are waived through the\n\u003e [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).\n\u003e\n\u003e All contributions to this project will be released under the CC0 dedication. By submitting a pull\n\u003e request, you are agreeing to comply with this waiver of copyright interest.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F18F%2Fcharlie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F18F%2Fcharlie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F18F%2Fcharlie/lists"}