{"id":26678219,"url":"https://github.com/telexintegrations/task-watch","last_synced_at":"2025-03-26T05:15:14.793Z","repository":{"id":279068951,"uuid":"937220812","full_name":"telexintegrations/task-watch","owner":"telexintegrations","description":"Telex integration for task management","archived":false,"fork":false,"pushed_at":"2025-02-23T14:54:29.000Z","size":184,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-23T15:34:55.215Z","etag":null,"topics":["bot","integrations","project-management","telex"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/telexintegrations.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":"2025-02-22T16:14:15.000Z","updated_at":"2025-02-23T14:54:32.000Z","dependencies_parsed_at":"2025-02-23T15:34:58.852Z","dependency_job_id":"106bca0e-dd40-47f6-b17f-ea6f3e265e79","html_url":"https://github.com/telexintegrations/task-watch","commit_stats":null,"previous_names":["telexintegrations/task-watch"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Ftask-watch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Ftask-watch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Ftask-watch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Ftask-watch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/telexintegrations","download_url":"https://codeload.github.com/telexintegrations/task-watch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245591533,"owners_count":20640692,"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":["bot","integrations","project-management","telex"],"created_at":"2025-03-26T05:15:14.082Z","updated_at":"2025-03-26T05:15:14.738Z","avatar_url":"https://github.com/telexintegrations.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TASK WATCH\n\n## Description\nTask Watch is a project management tool implemented as a **Modifier Integration** for Telex. It enables teams within Telex channels to create, delegate, manage, and set deadlines for tasks efficiently.\n\n## Features\n- Create and assign tasks using a preset delimiter.\n- View all created tasks.\n- Delete tasks when no longer needed.\n- Mark tasks as complete upon completion.\n- Receive notifications in the channel when a task is due but not marked as complete.\n\n## App Usage on Telex\n### Setting Up the App\nTo begin using Task Watch on Telex, follow these steps:\n\n1. **Log in to [Telex](https://telex.im/)** (or sign up if you don’t have an account) and select the organization where you want to install the integration.\n2. Navigate to the **[Apps](https://telex.im/dashboard/applications)** tab and click **Add New**.\n3. Copy and paste the following URL into the popup modal that appears:\n   ```\n   https://task-watch-production.up.railway.app/integration.json\n   ```\n4. Click **Save**, and once the application appears in the list of installed apps, click **Manage App**.\n5. In the **Description** tab, click **Connect App** to start using Task Watch.\n6. Go to the **Settings** tab, where you can configure:\n   - **Task Creation Keyword:** This is the keyword that the app recognizes as a task creation trigger. The default keyword is `TODO:` (including the colon).\n   - **Channel ID:** Specify the channel ID of the channel where the app should operate.\n   - **Output:** In the output tab, under configured channels, select the custom channels button and then uncheck every other channel except the channel where you want the app to work.\n\n### Integration Usage in Channel\nAfter the successful setup, head to the channel whose ID was added in the settings to use the app.\nTo get the full application documentation with examples, send this message:\n```\n/tasks-info\n```\n\nTo get a list of operation commands, send this message in the channel:\n```\n/tasks-man\n```\n\nTo create a new task in channel do:\n```\nTODO: \u003cnew task\u003e @assignee /d YYYY-MM-DD HH:MM\n```\nE.g\n\n![Create task example](https://i.ibb.co/rR5XhqBw/Screenshot-from-2025-02-23-22-18-21.png)\n\n\nResult:\n\n![Create task example](https://i.ibb.co/bMJ5cSdv/Screenshot-from-2025-02-23-22-15-15.png)\n\nFollow the instructions in these two commands to begin using Task Watch.\n\n## App Usage Locally\nTo use Task Watch locally:\n\n1. Clone this repo using:\n   ```\n   git clone git@github.com:telexintegrations/task-watch.git\n   ```\n2. `cd` into the newly created directory `task-watch` and run: \n   ```\n   npm install\n   ```\n3. Make the bash script `test_script.sh` in the root directory of the project executable by running:\n   ```\n   chmod +x ./test_script.sh\n   ```\n4. Run the app in development mode with:\n   ```\n   npm run start:dev\n   ```\n5. Run the bash script like so:\n   ```\n   ./test_script.sh '\u003cYOUR_CHANNEL_ID\u003e' 'EXAMPLE MESSAGE HERE'\n   ```\n\n**NB:** You need to retrieve your channel ID from Telex.\n\n## Hosting the Integration Yourself\nTo host the integration yourself:\n\n1. Fork this repo.\n2. Choose an app hosting service of your choice (e.g., Render, Railway, etc.).\n3. Add the following environment variables to your deployment settings:\n   ```\n   TARGET_URL=https://\u003cyour-deployment-domain\u003e/format-message\n   TICK_URL=https://\u003cyour-deployment-domain\u003e/format-message\n   WEBSITE=https://\u003cyour-deployment-domain\u003e\n   ```\n4. In the integration settings, add your hosted app using the `integration.json` file from our hosted application with this URL:\n   ```\n   https://\u003cyour-deployment-domain\u003e/integration.json\n   ```\n5. Add the channel ID of the channel where you want to install the integration.\n6. Uncheck all other channels in your organization except the channel whose ID was added in the settings to prevent messages from spamming other channels.\n\n## Example\n### 1. Creating a New Task\n```\n$ ./test_script.sh \u003cCHANNEL_ID\u003e 'TODO: warm eba @hng_mentors /d 2025-02-23 18:00'\n\n{\n   \"event_name\":\"🎯 New task\",\n   \"message\":\"\u003ch1\u003e\u003cb\u003e🎯 New Task\u003c/b\u003e\u003c/h1\u003e \\n\u003cb\u003eTask ID:\u003c/b\u003e #4\\n\u003cb\u003e📋Task:\u003c/b\u003e  warm eba \\n\u003cb\u003e👨🏻‍💻 Assigned to:\u003c/b\u003e @hng_mentors\\n\u003cb\u003e📅 Due By:\u003c/b\u003e Sunday, February 23, 2025, 19:00\\n\",\n   \"status\":\"success\",\n   \"username\":\"Task Bot\"\n}\n```\n\n### 2. Fetching All Tasks in a Channel\nThe output for this task is sent to the channel by the application. So you need to check the channel for the message.\n```\n$ ./test_script.sh \u003cCHANNEL_ID\u003e '/tasks'\n```\n\nResponse:\n```\n{\n   \"event_name\":\"message-formatted\",\n   \"message\":\"\u003cb\u003e\u003ci\u003e🎯 performed task operation: /tasks\u003c/i\u003e\u003c/b\u003e\",\n   \"status\":\"success\",\n   \"username\":\"sender\"\n}\n```\n\nThe message sent to the channel will look something like this:\n\n![Channel message example](https://i.ibb.co/jv2XJt6F/Screenshot-from-2025-02-23-18-00-31.png)\n\n## Contributing\nWe welcome contributions! To get started:\n\n1. **Fork the repository** and create your own branch.\n2. **Make your changes** and ensure they follow the project's guidelines.\n3. **Commit your changes** with a clear and concise commit message.\n4. **Push your changes** to your forked repository.\n5. **Open a pull request** with a detailed explanation of the changes you've made.\n\n## Resources\n1. **[TELEX](https://telex.im/)**\n2. **[TELEX DOCUMENTATION](https://docs.telex.im/docs/intro)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Ftask-watch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelexintegrations%2Ftask-watch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Ftask-watch/lists"}