The latest articles on DEV Community by Gustavo Soares (@gusssoares). https://dev.to/gusssoares https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F528420%2Ff2fbb7e8-1e75-4c56-9a31-f03d9388d54f.png https://dev.to/gusssoares en Gustavo Soares Mon, 10 Mar 2025 20:17:00 +0000 https://dev.to/gusssoares/pomodoro-cli-uma-ferramenta-simples-e-eficiente-para-aumentar-sua-produtividade-114a https://dev.to/gusssoares/pomodoro-cli-uma-ferramenta-simples-e-eficiente-para-aumentar-sua-produtividade-114a <p>Olá, pessoal do <strong>dev.to</strong>! 👋</p> <p>Hoje, estou muito empolgado em compartilhar com vocês uma ferramenta que criei para ajudar a manter o foco e aumentar a produtividade: <strong>Pomodoro CLI</strong>. 🍅</p> <h3> O que é o Pomodoro? </h3> <p>Se você ainda não está familiarizado com o método <strong>Pomodoro</strong>, ele é uma técnica de gestão de tempo que divide o trabalho em intervalos de tempo de 25 minutos, seguidos por uma pausa curta. Após quatro ciclos de <strong>Pomodoro</strong>, você faz uma pausa mais longa. Essa técnica é super eficiente para evitar a procrastinação e aumentar a produtividade.</p> <h3> Por que criar o Pomodoro CLI? </h3> <p>Embora existam várias ferramentas e aplicativos por aí, eu queria algo <strong>simples, minimalista</strong> e que pudesse ser usado diretamente no terminal (porque, sejamos honestos, quem não ama uma boa ferramenta de CLI, né?). 😄</p> <p>A ideia por trás do <strong>Pomodoro CLI</strong> é oferecer uma maneira de <strong>focar</strong> no trabalho sem distrações, tudo no seu terminal, de forma super simples e funcional.</p> <h3> Funcionalidades </h3> <ul> <li> <strong>Contagem regressiva</strong> para o Pomodoro e a pausa.</li> <li> <strong>Notificações</strong> no terminal para te avisar quando o Pomodoro ou a pausa terminou.</li> <li>Configuração fácil e flexível de tempos de trabalho e pausa.</li> <li> <strong>Sem interface gráfica</strong>, apenas o terminal, para quem ama praticidade.</li> <li> <strong>Efeito sonoro</strong> para avisar que a pausa iniciou e termino; possibilidade de mutar o efeito sonoro</li> <li> <strong>Restaurar</strong> o pomodoro caso você tenha encerrado a aplicação sem querer</li> </ul> <h3> Como usar? </h3> <ol> <li> <strong>Instalação</strong>: Para instalar a ferramenta, basta executar um dos seguintes comandos:</li> </ol> <ul> <li>Com <strong>pip</strong>: </li> </ul> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="nv">$ </span>pip <span class="nb">install </span>pomodoro-app-cli </code></pre> </div> <ul> <li>Ou com <strong>pipx</strong>: </li> </ul> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="nv">$ </span>pipx <span class="nb">install </span>pomodoro-app-cli </code></pre> </div> <div class="crayons-card c-embed text-styles text-styles--secondary"> <div class="c-embed__cover"> <a href="https://pypi.org/project/pomodoro-app-cli/" class="c-link s:max-w-50 align-middle" rel="noopener noreferrer"> <img alt="" src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fpypi.org%2Fstatic%2Fimages%2Ftwitter.abaf4b19.webp" height="300" class="m-0" width="300"> </a> </div> <div class="c-embed__body"> <h2 class="fs-xl lh-tight"> <a href="https://pypi.org/project/pomodoro-app-cli/" rel="noopener noreferrer" class="c-link"> pomodoro-app-cli · PyPI </a> </h2> <p class="truncate-at-3"> 🌟 Pomodoro CLI 🍅⏳ A simple and practical Pomodoro tool for your terminal! 📱💻 Organize your time efficiently with countdowns and sound alerts. Perfect for boosting productivity with focus and breaks! 🚀 </p> <div class="color-secondary fs-s flex items-center"> <img alt="favicon" class="c-embed__favicon m-0 mr-2 radius-0" src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fpypi.org%2Fstatic%2Fimages%2Ffavicon.35549fe8.ico" width="800" height="400"> pypi.org </div> </div> </div> <ol> <li> <strong>Uso</strong>: Depois de instalar, basta rodar o seguinte comando no terminal para começar: </li> </ol> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="nv">$ </span>pomodoro <span class="nt">--help</span> usage: pomodoro <span class="o">[</span><span class="nt">-h</span><span class="o">]</span> <span class="o">[</span><span class="nt">-r</span><span class="o">]</span> <span class="o">[</span><span class="nt">-m</span><span class="o">]</span> <span class="o">[</span><span class="nt">-c</span><span class="o">]</span> <span class="o">[</span><span class="nt">-v</span><span class="o">]</span> options: <span class="nt">-h</span>, <span class="nt">--help</span> show this <span class="nb">help </span>message and <span class="nb">exit</span> <span class="nt">-r</span>, <span class="nt">--restore</span> restore previous pomodoro closed <span class="nt">-m</span>, <span class="nt">--mute</span> mute pomodoro alarms <span class="nt">-c</span>, <span class="nt">--config</span> <span class="o">(</span>coming soon<span class="o">)</span> configure <span class="nb">times </span>to your custom values <span class="nt">-v</span>, <span class="nt">--version</span> show current version </code></pre> </div> <p><a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F3r1hk5svxvvmegz4b2yn.png" class="article-body-image-wrapper"><img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F3r1hk5svxvvmegz4b2yn.png" alt="Image description" width="723" height="478"></a></p> <p>E pronto! A ferramenta vai iniciar o ciclo Pomodoro e começar a contagem regressiva. Você pode personalizar os tempos de Pomodoro e pausa de acordo com suas necessidades.</p> <h3> Por que você vai gostar? </h3> <ul> <li> <strong>Leve e direto ao ponto</strong>: A interface do terminal é rápida e não tem distrações.</li> <li> <strong>Fácil de personalizar</strong>: Modifique os tempos de pomodoro e pausa para se adequar à sua rotina.</li> <li> <strong>Códigos simples e abertos</strong>: O código está totalmente disponível no GitHub para você contribuir ou fazer suas próprias melhorias.</li> </ul> <h3> Como contribuir? </h3> <p>Se você se empolgar com a ferramenta, adoraria que você contribuísse! 🌟 O repositório está aberto para contribuições de qualquer tipo. Se você quiser sugerir melhorias, corrigir bugs ou adicionar novas funcionalidades, fique à vontade para abrir um <strong>pull request</strong> ou <strong>issue</strong>.</p> <h3> Conclusão </h3> <p>A produtividade é algo que todos buscamos, e com pequenas mudanças em como gerenciamos nosso tempo, conseguimos resultados incríveis. O <strong>Pomodoro CLI</strong> foi minha forma de criar uma ferramenta que complementasse esse método de maneira simples e eficaz.</p> <p>Espero que essa ferramenta ajude você a manter o foco e a ser mais produtivo! Não se esqueça de conferir o código no GitHub e, se possível, dar aquela estrela ⭐️!</p> <p><strong>Link do Repositório</strong>: </p> <div class="ltag-github-readme-tag"> <div class="readme-overview"> <h2> <img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fassets.dev.to%2Fassets%2Fgithub-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"> <a href="https://github.com/GussSoares" rel="noopener noreferrer"> GussSoares </a> / <a href="https://github.com/GussSoares/pomodoro-cli" rel="noopener noreferrer"> pomodoro-cli </a> </h2> <h3> 🌟 Pomodoro CLI 🍅⏳ A simple and practical Pomodoro tool for your terminal! 📱💻 Organize your time efficiently with countdowns and sound alerts. Perfect for boosting productivity with focus and breaks! 🚀 </h3> </div> <div class="ltag-github-body"> <div id="readme" class="md"> <div class="markdown-heading"> <h1 class="heading-element">Pomodoro CLI ⏳</h1> </div> <p><a href="https://github.com/GussSoares/pomodoro-cli/actions/workflows/test.yml" rel="noopener noreferrer"><img src="https://github.com/GussSoares/pomodoro-cli/actions/workflows/test.yml/badge.svg" alt="Ruff Tests"></a> <a href="https://github.com/GussSoares/pomodoro-cli/actions/workflows/publish.yml" rel="noopener noreferrer"><img src="https://github.com/GussSoares/pomodoro-cli/actions/workflows/publish.yml/badge.svg" alt="Release"></a></p> <p>A simple and practical Pomodoro tool for your terminal! 📱💻</p> <p>Organize your time efficiently with countdowns and sound alerts. Perfect for boosting productivity with focus and breaks! 🚀</p> <div class="markdown-heading"> <h2 class="heading-element">Features:</h2> </div> <ul> <li>Start, pause, and restart Pomodoro cycles 🍅⏳</li> <li>Sound notifications to keep you on track 🔔</li> <li>Customizable work and break durations <em>(coming soon)</em> ⏰</li> <li>Simple and intuitive terminal interface</li> </ul> <div class="markdown-heading"> <h2 class="heading-element">Installation:</h2> </div> <p>You can install Pomodoro CLI directly from PyPI using pip:</p> <div class="highlight highlight-source-shell notranslate position-relative overflow-auto js-code-highlight"> <pre>pip install pomodoro-app-cli</pre> </div> <div class="markdown-heading"> <h2 class="heading-element">Usage:</h2> </div> <p>Start your Pomodoro session by running:</p> <div class="highlight highlight-source-shell notranslate position-relative overflow-auto js-code-highlight"> <pre>pomodoro</pre> </div> <div class="markdown-heading"> <h2 class="heading-element">License:</h2> </div> <p>This project is licensed under the <a href="https://github.com/GussSoares/pomodoro-cliLICENSE" rel="noopener noreferrer">MIT License</a> - see the LICENSE file for details. 📜</p> </div> </div> <br> <div class="gh-btn-container"><a class="gh-btn" href="https://github.com/GussSoares/pomodoro-cli" rel="noopener noreferrer">View on GitHub</a></div> <br> </div> <br> <p>Gostou da ferramenta? Comente aqui o que você achou, e compartilhe suas experiências com o método Pomodoro! 😄</p> <p>Até a próxima! 👋</p> python pomodoro cli terminal