Inspiration
I have plenty of unfinished projects myself. Some are apps I stopped working on months ago. Others are ideas that still sound exciting, but I no longer remember what worked, what was broken, or what I was supposed to do next.
At first, I thought this was simply a productivity problem. Maybe people needed better reminders or more discipline. But the more I explored it, the clearer it became that people stop for many different reasons. The project grows too large. The finish line disappears. Progress becomes difficult to see. Perfectionism makes every decision feel risky. Sometimes the person simply loses confidence or feels alone.
I also realized that not every project should be finished. Some should be tested, reduced, paused, or closed. But even a project that is abandoned can contain valuable ideas and skills.
That is why I created Motivatoro. I wanted something that could understand an old project, help me remember what it was meant to become, and give me an honest and manageable way forward.
What it does
Motivatoro helps people decide what to do with their unfinished projects and then supports them through the next steps.
A user can add one project, scan an existing folder, or compare several projects competing for their attention. Motivatoro looks at the available progress, remaining effort, usefulness, evidence of demand, personal interest, learning value, and differentiation.
The user remains in control of what matters. They can prioritize the easiest project to finish, the most useful one, the best learning opportunity, or create their own balance.
Motivatoro does not simply produce a score. It explains:
- why the project might be worth finishing;
- what the person could gain from completing it;
- what is most likely to get in the way;
- what a small but useful finished version could look like;
- whether the project should be continued, tested, used for learning, paused, or closed.
When a user chooses a project, Motivatoro creates a plan based on that specific project. Each mission explains what to do, why it matters, what skill the user is developing, and what result will show that the step is complete.
The experience also includes XP, badges, skill progression, focus timers, streaks, and visible milestones. These are not rewards for clicking buttons. They are connected to actual work, evidence, learning, and completed outcomes.
Toro is the built-in GPT-5.6 project companion. It can help when the user feels confused, bored, overwhelmed, afraid of making the wrong decision, or unsure what to do next. Toro stays focused on the selected project instead of becoming a general-purpose chatbot.
Motivatoro can also guide a project toward launch by adding validation, positioning, user feedback, and go-to-market missions when they are relevant.
How we built it
I built Motivatoro with Codex using GPT-5.6 through a very iterative process.
I started with a basic project-ranking idea, tested it, and quickly discovered that it was too mechanical. The questions sounded robotic, the recommendations were too general, and the interface did not make the next action obvious.
I repeatedly gave Codex real examples and direct feedback. I showed it forgotten project folders, broken layouts, unclear buttons, generic plans, and chatbot responses that did not feel human. Codex helped me inspect the projects, understand what they were supposed to do, identify the underlying product problems, and turn each round of feedback into working improvements.
Codex accelerated the folder-analysis logic, personalized missions, learning system, gamification, Toro Chat, responsive interface, cost controls, automated tests, security checks, documentation, GitHub preparation, and deployment.
The application uses Node.js with an HTML, CSS, and JavaScript frontend. OpenAI's Responses API powers the AI workflows, with structured outputs where predictable data is important. Toro Chat uses GPT-5.6 Luna and receives limited context about the selected project.
Folder scanning begins on the user's computer. Files that appear to contain secrets, dependencies, binaries, or generated build output are excluded. The application also includes input limits, scoped chat history, fallback behavior, and an AI spending guard.
Motivatoro is containerized with Docker and deployed publicly through Render. It also includes a complete demo mode, so the core experience remains available if a live AI request fails.
Challenges we ran into
The biggest challenge was making the advice genuinely specific.
An old project may contain hundreds of files, outdated documentation, unfamiliar terms, experiments, debug output, and features that were never completed. Finding a technical file is easy. Understanding what the project was meant to become, how far it progressed, and what the person should do next is much harder.
Another challenge was simplicity. Early versions asked too many questions and used language that sounded like it came from a project-management robot. Some buttons were difficult to find, instructions were unclear, and the learning experience felt more like filling in a form.
I had to keep removing complexity, increasing readability, and making every screen answer three basic questions:
- What am I looking at?
- Why does it matter?
- What should I do next?
Toro Chat created a different challenge. At one point, a user could say, "I'm sad working on this," and receive a long version of the project plan. That was technically relevant but emotionally useless. Toro needed to recognize the feeling first, reduce the pressure, and then offer a small and realistic next step.
I also had to balance AI quality with cost, latency, privacy, reliability, and useful fallback behavior.
Accomplishments that I'm proud of
I am proud that Motivatoro became much more than the original ranking tool.
It now provides a complete path from "I found this forgotten folder" to "I understand what this project is, why it matters, and what I can do next."
Motivatoro can:
- recover the purpose and current state of a forgotten project;
- compare several projects using priorities chosen by the user;
- explain the real benefits of finishing;
- suggest a smaller and more believable finish line;
- generate next steps connected to the actual project;
- turn those steps into a structured learning journey;
- connect progress to skills, XP, badges, and milestones;
- provide supportive help through a project-scoped GPT-5.6 companion;
- remain usable when live AI is unavailable.
I am also proud that the final result is publicly deployed and includes Docker support, privacy safeguards, cost controls, judge documentation, and 49 automated tests covering the core behavior.
What I learned
The biggest thing I learned is that motivation often comes after clarity, not before it.
Telling someone to work harder is rarely useful. Showing them why the project matters, reducing the size of the next step, and making progress visible can change how the work feels.
I also learned that gamification needs meaning. XP and badges are useful when they represent something real, such as a finished artifact, a tested assumption, a new skill, or feedback from another person. They become distracting when they only reward activity.
Finally, I learned that understanding a project's files is not enough. A useful AI companion also needs to understand the human situation around the project. Is the user confused? Bored? Afraid of failing? No longer interested? The correct next step depends on both the project and the person working on it.
What's next for Motivatoro
The next step is to test Motivatoro with more people and more types of unfinished work, including writing, education, creative projects, small businesses, and personal goals.
I would also like to add secure accounts, cross-device projects, deeper GitHub and cloud-drive imports, shared accountability, and better long-term progress insights.
The learning system can grow into a more adaptive skill map with stronger assessments, reflection, mentor feedback, and personalized paths from idea to launch.
My long-term goal is simple: when someone finds an old project they still care about, Motivatoro should help them understand it, make an honest decision, learn what they need, and take the next step toward finishing it.
Built With
- codex
- css3
- docker
- gpt-5.6
- html5
- javascript
- node.js
- openai
- openai-api
- render
Log in or sign up for Devpost to join the conversation.