Skip to content

ApenasGabs/todoist-sync-bot

Repository files navigation

🧩 todoist-sync-bot

Deploy on Vercel MIT License Issues Stars Forks GitHub LivePix - Apoie este projeto

📝 Descrição

Crie tarefas automaticamente no Todoist a partir de issues abertas em repositórios GitHub – simples, rápido e gratuito. Ideal para quem quer integrar planejamento pessoal com fluxo de desenvolvimento.

✨ O que ele faz?

Quando uma issue é aberta em um repositório GitHub conectado, o bot cria automaticamente uma tarefa no seu Todoist com:

  • O título da issue (como nome da tarefa)
  • O corpo da issue (como descrição da tarefa)
  • Um link direto para a issue
  • Uma label GitHub para organização

⚙️ Como usar sem fazer deploy (usando o GitHub App)

Você pode usar essa integração sem clonar nada ou fazer deploy manual. Basta:

  1. Instalar o GitHub App:

    👉 Clique aqui para instalar o todoist-sync-bot

  2. Configurar sua chave do Todoist:

    Após instalar, o app tentará enviar as tarefas para o seu Todoist. Para isso funcionar, você precisa fornecer sua chave de API do Todoist.

    Hoje, como a versão pública não possui interface de configuração, você pode:

    • Fazer seu próprio deploy (veja abaixo) com sua própria TODOIST_API_KEY
    • Ou abrir uma issue com sugestões sobre como quer autenticar sua conta Todoist

🚀 Deploy rápido com Vercel

  1. Clone o repositório:

    git clone https://github.com/ApenasGabs/todoist-sync-bot.git
    cd todoist-sync-bot
  2. Configure as variáveis de ambiente:

    Na Vercel ou localmente (.env.local):

    GITHUB_WEBHOOK_SECRET=uma-senha-secreta
    TODOIST_API_KEY=sua-chave-do-todoist
    
  3. Crie um webhook no GitHub:

    No repositório que deseja integrar:

    • Vá em Settings > Webhooks
    • URL: https://seu-projeto.vercel.app/github-webhook
    • Content type: application/json
    • Secret: a mesma que está em GITHUB_WEBHOOK_SECRET
    • Evento: selecione Issues (ou “Let me select individual events” e marque “Issues”)
  4. Pronto! Sempre que uma issue for aberta, uma task será criada no seu Todoist 🎯

🛠 Tecnologias usadas

🤝 Contribuição

Este projeto é open-source e gratuito para todos. Se quiser sugerir melhorias ou corrigir algo, fique à vontade para abrir uma issue ou um PR.

📄 Licença

MIT — use como quiser 🙌


Feito com 💛 por @ApenasGabs

Releases

No releases published

Packages

No packages published